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Overview 








OVERVIEW 


This User Guide describes how to use the FormScape Developer module to create and save your FormScape 
projects. 


The FormScape Developer module is used to design your new electronic form layout using graphical objects 
on a tree structure to process data. In conjunction with the Server module you can define the inputs and 
design and direct the output from it. During the design process you can also test your work by previewing it 
or printing it, so that you can see the results of your work as it progresses. 


Installation of the FormScape Developer module is described elsewhere in the FormScape Installation Guide. 
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1 GETTING STARTED 


1.1 INTRODUCTION 


This section of the User Guide describes how to get started using the FormScape Developer module by 
creating a simple form design as an initial exercise. This is followed by a more detailed explanation of the 
FormScape project tree and how to move around it, followed by tutorial exercises using prepared sample 
data. 


It is recommended that you select the ‘Show HelpLinks’ option from the Documentation Options dialog 


(select Documentation from the Options menu). These links allow you to display information on the object. 
The screen shots in this document have been taken with this setting enabled. 


1.2 INITIAL EXERCISE 


To gain experience and confidence in using the FormScape Developer module, the initial exercise described 
below is recommended. In it you will design a simple form layout comprising text and graphics using some 
of the forms editor features and print it as a sample form. The steps involved in carrying out this initial 
exercise are described in some detail, but the subsequent tutorial exercises are less so, making use of the 
experience gained in the initial exercise. You are of course free to experiment at any time as you work 
through the exercises by trying options and features of particular interest. 


Carry out the following steps: - 


1. To start Developer, click on Start|Programs|FormScape2|Developer. The Developer logo 
appears, followed by a full-screen view of the project ‘tree’. 
tes 2. Click on the cross to the left of the First Action icon. 


(3) 3. Click on the cross next to the Pages icon. 


4. Click on the Form (Graphic) icon. A blank page with a grid at one-inch intervals appears 


es in a Graphic editor window - this is the blank sheet on which you are to create your form 
design. A tool bar at the top of the screen shows available tools for editing/creating the 
form layout. 
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5. Click on the Zoom Out button in the tool bar until the entire blank page is displayed. 


6. Click on the line draw button and draw a vertical line on the blank page by clicking on a 
start point and then dragging. On the tool bar above the Graphic editor window, click on 
the line thickness and line style boxes to select a line thickness of 2 pt and a dashed style. 





7. Click on the box draw button in the tool bar and draw a rectangle on the page by clicking 
on a grid intersection and dragging down to the right to a further grid intersection, making 
a rectangle of three grid squares wide by two grid squares deep. Select a line thickness and 
style e.g. 1 pt and continuous. 





8. Click on the text button and draw a rectangle on the page by clicking on a start point and 
dragging down to the right. Make this rectangle two grid squares wide by one grid square 
deep. A further window opens with a flashing cursor. Type in the word STATEMENT, 
and press Enter to finish, as instructed. The word STATEMENT now appears in the 
highlighted text box. Select a font and point size e.g. Arial 16 pt, by clicking on the 
appropriate tool bar menus above the Graphic editor window. 





veces 9. Click on the picture button and draw a rectangle on the top left of the page by clicking on a 

ta start and end point as before. Make this rectangle one grid square in each direction. A 

BOEGE: window opens for you to select a graphics file to insert in the highlighted rectangle. Select 
the file (Windows bmp _§ format) by browsing for C:\program 
filesYormscape2\examples\fslogo.bmp. Double-click on the file name to insert the graphic 
in the highlighted rectangle. The FormScape logo should now appear on the page. 


10. Click again on the box button and draw a rectangle on the page that is two grid squares 
wide by half a square deep. Select the line style and thickness to be continuous and 4 pt. 
Click on the box shadow button above the Graphic editor window. The Shadow window 
appears. Click on Draw Shadow and enter an offset of 0.1 inches. Click on the OK button. 
The rectangle you have drawn now has a drop shadow added to it. You can also select a 
color (the default color is black) for the shadow by clicking on the Set Color button in the 
Shadow window to produce a color palette. 





11. Asa further refinement, with this rectangle still highlighted, click on the rounded corners 
button above the Graphic editor window. The Rounded Comers window now appears. 
Click on “Draw rounded corners” and enter a size of 0.2 inches. Click on OK. Your drop 
shadow rectangle now has rounded corners added to it. 





12. As a further extension of this feature, draw a rectangle one grid square, and select the 
rounded corners button as before. Select a size of 0.5 inches i.e. half the size of the 
rectangle in each direction. Click on OK. This square has now been transformed into 
circle. (Note that it also has a shadow added to it that can be removed if desired by 
unclicking the Draw shadow box in the Shadow window). A circle can alternatively be 
produced by clicking on the Ellipse button (next to the box draw button on the toolbar) and 
dragging a square on the form — the ellipse contained within the square now becomes a 
circle, since its vertical and horizontal axes are identical. 





__..,_ 13. Click on the barcode box and draw a rectangle on the page that is one grid square wide by 

ale half a square deep. Right-click on this rectangle and select Explore from the floating menu. 

poss The screen now shows the project tree in the Exploring pane alongside the Graphic editor 
window. 


In the Exploring pane, notice that you have now added a branch called Barcode at the end 
of the tree. Click on the cross to the left of the Barcode icon on the tree: a sub-branch 
labeled ‘Input =‘ appears below the Barcode icon. Click on the Input icon (pair of open 
and close quote marks) to open a Text editing box. Type in the numbers “12345” in this 
box, and click on OK. A barcode representing these numbers now appears in the 
highlighted rectangle on the Graphic editor window. Double-click on this rectangle to open 
the Bar Code Properties dialog box. Select Code 39 in the Symbology box, Horizontal in 
the Orientation box and Raw from the Human Readable drop-down list. 
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14. 





(1) 


(4) 


(5) 


Click on OK. Now stretch the bottom of the highlighted barcode rectangle to one square 
deep to reveal below the barcode the numbers 12345. 


In the tool bar, click on the printer button to perform a test print of the page. The form you 
have designed should look similar to that shown below, and incorporate the following 
features :- 


(1) the text ‘STATEMENT ' in Arial 16 pt font 
(2) a graphic (the FormScape logo) 


(3) a blank rectangle with a thick continuous frame, drop shadow effect and rounded 
comers 

(4) a blank rectangle with a continuous frame around it 
(5) a vertical dashed line 
(6) a barcode representing the numbers 12345 
(7) a blank circle with a thick continuous edge 
Click on the double-headed arrow on the top left of the Graphic editing window and select 
“Remove Pane’ to return to the Exploring project tree view. In the File menu at the top of 
the screen click on Save As and then the To the Server sub-option. A display box shows 
the root folder on the Server. Click on the root folder and open the sub-folder Processes. 
Enter a filename e.g. “Exercise!” and save your project by clicking on OK. The file is 
automatically saved to the server. You have now designed the sample form layout shown 
below using the Developer module of FormScape. 

(2) Gea : STATEMENT 

) MT 

12345 


>—-O 





Sample form layout (exercise 1) showing some of the form editing features 
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1.3 “NAVIGATING” AROUND THE PROJECT TREE 


As you have already discovered in the initial exercise, when you first ran FormScape Developer, the project 
opens with a tree view in the Exploring pane. This view allows you to manipulate the project tree directly by 
adding further icons to add-points on the tree. 


The top of the tree shows an icon (labeled ‘Process’) depicting the Queue Process for this part of 
the project - everything that you set up within the tree structure will be a function performed 
within this branch of the project. 








You can start a new branch or open an existing branch using the File menu or the icons on the tool bar. You 
can save a branch you are working on using the File menu or the Save icon on the toolbar. Branches are 
saved with a .FSP extension. 


1.3.1 WINDOW PANES 


The view in the Developer module shows the menus and a tool bar at the top of the screen, and the tree as a 
full-screen view. During the development process you may want to see two or more parts of the tree at the 
same time, or you may want to simultaneously display your captured data and the form you are currently 
designing. You can divide the main screen into any number of sub-windows referred to as “panes”. 


| The active pane (always distinguished from any others on the screen by a colored bar at the top) can 
be divided horizontally or-vertically. The icon that allows you to do this is the small double arrow at 
the top left of the active pane. When you click this, a small menu drops down, allowing you to split 
the screen, remove the pane altogether, or change the view to small icons so that you can get more of 
the tree on the screen. 





Alternatively, you can click the right mouse button when the cursor is in the active pane. A menu appears 
that allows you to split or unsplit the screen. In this case a vertical pane will split into two horizontal ones, 
and a horizontal pane will split to produce two vertical panes. 


At the top right of each pane there is a small cross icon which allows you to restore the tree view 
in the active pane. This.jcon only appears if the pane is currently displaying anything other than 
the tree view. 





The size of the individual panes can be changed by placing the cursor on the vertical or horizontal bar that 
splits the window, and dragging it to.a new position using the left mouse button. 


A quick method of re-arranging the panes on the screen is by dragging the bar at the top of the active pane 
into one of the others. This will change the layout of the existing panes on the window. 
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1.3.2 THE FORMSCAPE TREE 


The key to using FormScape is managing the project tree by building up a number of connected objects 
(icons) which interact to perform the required functions. Many objects can be added to the tree using the 
high level editors, but you will also need to learn how to manipulate the tree directly to gain maximum 
benefit from FormScape. 


1.3.3 WHY USE A TREE ? 


FormScape makes use of a tree structure for holding all the objects in your project together. As FormScape 
is primarily a programming environment, any object placed on the tree receives its settings from other objects 
connected to it. By using the extensive linking ability of these objects, it is possible to alter the inputs to an 
object dynamically. For example, the color of a printed number could be linked to a value that appears 
within the data, for example only negative numbers could be printed in red, with all others black. 


1.3.4 LABELLING THE TREE 





Next to each object on the tree is a small text label. These labels are automatically assigned a default text as 
you add them to your FormScape project. It is strongly recommended that you edit these labels to suit your 
own requirements as you produce them. To alter a label, double-click on the text. A Rename dialog box 
opens, which allows you to change the text. 


In addition, there is a ‘Documentation’ facility available for adding an optional comment to your object label, 
and this comment may be displayed as an additional green text alongside the label. To use this feature, select 
the label of the object to which you wish to add a comment by clicking on it, select the Documentation 
Viewer option from the View menu and enter the comment in the Documentation Viewer window. When 
you close this window your comment appears alongside the object’s label. If you select the Documentation 
option in the Options menu, you can further choose whether to display the comment on the tree or not, and 
how many characters of the comment to display (in the range 5-200 characters). Note that a displayed 
comment will also be printed if you use the Print Tree option to print a tree view. 


Note: The example diagrams in this document show the Documentation Option “Show object type 
hyperlinks” enabled (select Documentation from the Option menu). 


1.3.5 EXPANDING THE TREE 





The tree can be expanded or contracted at any time so that you can arrange the various objects you want to 
work with on the screen. The tree structure has small square ‘joints’ which display either a + or a -. 
Clicking on a plus (+) joint will expand the tree, while clicking on a minus (-) joint will contract it. 
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OBJECT EDITORS 


Each object on the normal tree view appears as an icon. There are two types of icon: depressed 
icons and engraved or flat icons. Clicking on an icon will open the editor associated with that 
icon, unless it is already open, then the editor window becomes active. The editors allow you to 
perform functions associated with that icon, or to alter the way it behaves. For example, 
clicking on a form icon opens the Graphic form editor in the current pane. 





1.3.7 CHANGING THE TREE ORDER 


It may be desirable or necessary to alter the order in which objects appear on the tree. Objects cannot be 
moved to a higher or lower level of the tree, but objects on the same level can be re-arranged into a different 
order. 


There are four icons at the top of the screen that allow the order of the objects to be 
changed: move to top, move up, move down and move to bottom. To move an 
object, click on its text label once with the left mouse button, and then click the 
appropriate tool to move it. 





1.3.8 ADDING OBJECTS TO THE TREE 


Objects are added to the tree in two ways. With a high level editor such as the Form Editor or the Page 
Mapper, objects are automatically added to the tree (as you design a form every piece of text that you add to 
the form is added as a text object on the tree). You can also add objects to the tree manually wherever you 
see a branch that has a small square stub “J (an add-point). Clicking on the add-point displays a Create 
Object dialog, which contains an alphabetical list of available objects grouped into an alphabetical list of 
categories. Choose the object you want to add to the tree from the window. When the object is added it may 
contain a sub-branch of other objects (child objects) which are automatically added. 


Create Object 


Deprecated 
Files 

Mail 

OD8C 
PageBanks 


Prarimanunaetn re 
Ty ile MIE rte %. 
anced | 
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1.3.9 DELETING OBJECTS FROM THE TREE 


It is also possible to delete objects from the tree. With a high level editor such as the Page Mapper or the 
Graphic form editor, select the object — for example, a rectangle — by clicking on it with the left mouse 
button, and then pressing the Delete key. However, if you want to delete objects from the tree directly, select 
the object on the tree by clicking the left mouse button on its text label and then press the delete key. 


Note that when deleting objects you may receive a warning message saying that the parent object (the object 
above it on the tree) requires the object, or that the object is linked to another object and cannot be deleted. 
This is because the object you are trying to delete is essential to the correct operation of its parent object. 


If an object is linked to another object it will be shown with a small yellow arrow pointing away from it. 
You will only be able to delete this object when you have removed the object it links to, which will be 
connected elsewhere on the tree. 


1.3.10 CHANGING OBJECTS ON THE TREE 


When you add objects to the tree, certain object structures or tree branches are added as defaults. The great 
versatility and flexibility of FormScape derives from the tree, which can be built and altered to perform 
functions that fulfill your specific requirements. 


This flexibility is achieved because the various objects you build the tree with are interchangeable. For 
example, you may design a form which has a piece of text on it stating ‘Cash Only’, and you may want to 
add this text to some forms only but not others. You will need to change the fext object on the tree into a 
testing object, which determines whether or not to print the text. In turn the testing object will need to be 
presented with some data from the current page in order to make its decision. In this way the project can 
grow and change to fulfill your precise requirement. 


As previously mentioned, to change an existing object from one type to another, point to the object and click 
the right mouse button. Select ‘Change Type’ from the drop-down menu. You are presented with a list of 
compatible object types in a Change Object window, similar to the Create Object window. 


Note: Objects can only be changed to a ‘similar’ or ‘compatible’ type. For example, it is not valid to 
change a Printer object into a Scheduler 
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1.3.11 COPYING OBJECTS ON THE TREE 


It is possible to copy objects from one part of the tree to another, but only if the target position is capable of 
accepting the object. For example, when you produce a ‘Print Graphic’ object on the tree, and you want to 
make a copy of it in order to produce a second sheet for another printer. (A Print Graphic object produces a 
sheet, normally with a form on it, and sends it to a specified printer.) To copy the object, place the cursor on 
the object you want to copy and using the right mouse button, drag it to the target part of the tree. You can 
copy the object to a different part of the tree in the same pane, or onto a part of the tree which is being 
displayed in another pane. 


When you release the right mouse button, a small menu (the ‘Drag’ menu) 
appears allowing you to cancel the operation, or to ‘Copy’ or ‘Link’ the object. 
Selecting ‘Copy’ from the menu causes the selected object, and all the object’s 
children (those objects attached below it on the tree), to be duplicated to make an 
identical copy. The new object is only identical at the time it is copied. It can 
then be altered independently of the original. 


A linked object is not a new object. It is a reference to the original, and any 
changes made to the original are applied to all its linked objects. 





Note that when dragging an object to a target position that is not an add-point, the 
object will always replace the target object. 


1.3.12 COPYING OBJECTS BETWEEN PROJECTS 


You may want to copy an object you have created into another project using a ‘branch’ file. Right click on 
the object you want to copy and select ‘Save As’ from the small menu. You then have the option of saving 
the object either to ‘localhost’ (the server) or your computer’s hard disk (‘My Computer’). Enter a file name, 
and the object you have selected (including all the child objects connected to it) is then saved as a FormScape 
branch file with the file extension .FSP. You can then paste this file into different projects by right clicking 
on an add-point in the project tree, selecting ‘Insert Copy of’, then either ‘localhost’ or ‘My Computer’ (as 
appropriate) and selecting the file from the list appearing in the Open Branch window. 


It is important to note that some of the objects within the branch file may have been linked to other objects in 
the original project, which do not exist in the new project. These links are automatically removed when the 
branch file is made. Links to other objects within a branch file always remain intact. 
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2 MANAGING A PROJECT 


The FormScape Server resides on a designated Windows NT4 Server machine, and the FormScape Server 
Service intercepts the print queues (file directories or mail accounts) looking for data that requires application 
intervention. It is completely transparent to the NT server and does not interfere with any print queues that 
have nothing to do with FormScape. The FormScape Server does not need to be installed or running on the 
same machine as FormScape Developer, it is recommended that it is installed on a machine or machines 
elsewhere on the network. 


The diagram below shows how two Developers can work on projects that are saved and running on one 
Server. Note that there is a system to ensure that two Developers are not accessing the same branch 
simultaneously. 





Server Service 


tJ Running All ga 
__ 1s Developer Projects 2 
p nammeraernr aas [Sa 


i gelelecis [Gp L110 he a ee eee eee Sy Pe Re ee eyes > Workstation using 
Developer Use & modify Developer 
common projects by 
retrieving from Server 


2.1 THE DEVELOPMENT ENVIRONMENT 


FormScape Developer includes a fully functional FormScape Server (with spoiler) which allows you to test 
projects on your local machine. Your local machine can be referred to as either “localhost” or the name of 
your machine (e.g. X00187). 


2.2 SAVING A PROJECT 


FormScape projects can be held either on your computer’s hard disk (To My Computer) or on the FormScape 
Server (To the Server at...) and all objects that are saved are referred to as a branch: a project can contain any 
number of branches. 


Select Save As from the File menu to save your branch. Two options appear in the sub-menu; “To My 
Computer” or “To the Server at...”. A project must be saved “To the Server at...” if you need the process to 
run. However, if you choose “ To My Computer” your branch is exported to a location of your choice. This 
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method should only be used for development purposes, because the process only runs if saved on the Server. 
Note that a branch saved in this way will have the filename extension .fsp. 


Typically, when developing a project, it would be saved locally to the Server for testing purposes. To do this 
select Save As “To The Server at...”. The Server defined here should either be localhost or the name of your 
computer (e.g. X00187). If the Server name is not correct then you will need to change the Server. See 
“Changing the Server” for more information. 


2.3 THE SERVER STRUCTURE 


Once Save As “To The Server at...” has been selected the display will show the root folder on that Server 
(which has the name name of computer. name of domain). To open a folder, double-click on the folder. 
Below that folder there will always be two folders which have special purposes, the Actions folder and the 
Processes folder. Only use the Processes and Actions folders if their functionality is required. 


2.3.1 PROCESSES FOLDER 


Any branch process that is saved to the 
Processes folder is automatically started. Note 
that by default the Input queue type is a Print 
Queue so for every Queue Process that is saved 
in this location a Printer will be created on your 
computer. 


(quProcesses 


2.3.2 ACTIONS FOLDER 


Any branch saved into the Actions folder is 
made available to the Viewer. 





2.3.3 CREATING NEW FOLDERS 


To create a new folder, double click on the folder where you wish to create your new folder. Right click on 
the folder and select New Folder. Enter a name when prompted. 


2.3.4 MANAGING ITEMS ON THE SERVER 


Any of the following functions are available from either the “Open from...” or “Save to...” dialog. Note that 
performing any of these functions may adversely affect any links between branches. 


2.3.4.1 CUT 


Right-click on a branch or folder and select Cut. Right click on the destination folder and select Paste. The 
branch will be deleted from the original location. 


2.3.4.2 COPY 


Right-click on a branch or folder and select Copy. Right click on the destination folder and select Paste. The 
branch will also remain in the original location. 


2.3.4.3 DELETE 


Right-click on the branch or folder that you wish to delete and select Delete. 


2.3.4.4 - RENAME 


Right-click on the branch or folder that you wish to rename and select Rename. 
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2.3.5 BRANCH PROCESSES 


A branch process is a branch that contains a process, and will be started automatically if the branch is saved 
in the Processes folder. Otherwise select Processes from the Server menu and log onto the server. Click Start 
and select the process that you want to start. Note that branch processes can be independently stopped and 
started — to stop a branch process highlight it and click on Stop. The Events window shows any current 
activity or error messages. 


2.4 CHANGING THE SERVER 


To be able to view another developer’s project or to save a project to a universally available machine, we 
need to define which Server to log in to. To do this, select Change Server option from the Server menu. 
Enter the Server machine’s name and it’s Domain, and also your User name and password on that machine. 


2.5 MANIPULATING PROJECTS OVER THE NETWORK 


First change the Server as described in the previous section. To Open a project, from the File menu, select 
Open “From the Server at...”. Locate the branch from the Processes (or other folder) on the named server 
machine. Note that if another Developer has a branch open, the branch icon will be displayed in red and it 
will not be possible to open the branch. 


When a project needs to be saved to a universally available machine, it would be saved to the specified 
Server. To do this, from the File menu select Save As.. 


By selecting “To the Server at...”, the project will be saved to that server machine and available to all 
Developers able to log in into that Server. Once selected the display will show the root folder on that Server 
(which has the name name of computer. name of domain ). To open a folder double left click on the folder. 
To automatically start a branch process, save it into the Processes folder. 


Note that when opening projects from a Server that is not on your local machine, different printer 
settings may have been used, or the printers may be unavailable to use. All print and page settings 
should be checked before running/saving the project. 


2.6 BACKING UP YOUR SERVER 


A project can contain any number of individual branches. It is possible to make a copy of all branches by 
saving each branch “To My Computer”, but this is time consuming and difficult to manage. Using the 
backup function will save a folder at the root level and will save all sub-folders and directories below. 


Access the Server by either selecting Save As “To the Server at...” or Open “From the Server at...”. Right 
click on the Folder (or branch) that you wish to backup. 


Osea tia teahait In this example, right clicking on the FormScape globe and 
2 A pthc —-—==2-]| selecting “Create Backup” will backup everything. Right clicking 
on x00187.afp.co.uk will backup everything held within that 
folder, but will not backup the “shared resources” folder. 


To restore from backup right-click on the FormScape globe and 
select “Restore from Backup”. Note that regardless of where you 
right-click to restore the backup, the folders and branches will be 
restored to their original location. 





Note that the Processes and Actions folder only have their special functionality when they are within the 
home folder (the name for the home folder is taken from the computer name and TCP/IP domain name). 
Therefore, if you restore a backup from one machine onto another the contents of the Processes folder will 
not automatically start and the contents of the Actions folder will not be available from the Viewer. This 
issue is addressed in Section 4.12. 
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2. SECOND EXERCISE 


This exercise is designed to demonstrate how to save branches and start processes on your local machine. As 
part of this exercise FormScape will create a printer called Invoice. Ifa printer already exists with this name, 
then it will be deleted. 


l. 


To start Developer, click on Start/Programs|FormScape2|Developer. A project will be created with 
default objects. We will use this project without any enhancements for this exercise. 


From the File Menu select Save As. 


Select To the Server at localhost (the name of your local machine is acceptable instead of localhost. 
Otherwise Select Change Server from the Server menu and change to localhost — see section 2.4) 


Open the Processes folder by double clicking on the Home folder and double clicking on the Processes 
folder. 


Enter the branch name ‘Invoice’. 


Click Save. It may be necessary to log onto the FormScape server at this point. Note that when you are 
returned to the Developer the Queue Process name has now been changed to Invoice. 


Check that the Queue Process has been started (select Processes from the Server menu). 


Check that the Print Queue “Invoice” has been created (from the Windows Start menu select 
Settings/Printers). 


The exercise above saved a process into the Processes folder so it would be automatically started. It will not 
always be desirable to automatically start all processes: in a development environment it may be necessary to 
create multiple branch processes and if the input type is a Print Queue (as is the default) then a printer will be 
created for each branch process that is saved. The next part of this exercise will describe saving the branch 
process into a different location and manually starting the process. 


A 


To start Developer, click on Start/Programs|FormScape2|Developer. A project will be created with 
default objects. We will use this project without any enhancements for this exercise. 


From the File Menu select Save As. 


Select To the Server at localhost (the name of your local machine is acceptable instead of localhost. 
Otherwise Select Change Server from the Server menu and change to localhost — see section 2.4) 


Double clicking on the home folder to open it. Right click on the home folder and select “Create 
Folder”. 


Enter the Folder name Test. 
Double click on the test folder that you have just created. 
Enter the branch name ‘Statement’. Click Save. 


Check that the Print Queue “Statement” has not been created (from the Windows Start menu select 
Settings/Printers). 


Check that the Queue Process has not been started (from the Server menu select Processes). 


. Click the Start button from the Processes dialog (select Processes from the Server menu). Locate and 


select the Statement branch and click OK. The process will now be started. 
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11. Check that the Print Queue “Statement” has been created (from the Windows Start menu select 
Settings/Printers). 


Finally, you should delete both of these branches from the Server. 


1. To start Developer, click on Start|Programs|FormScape2|Developer. A project will be created with 
default objects. We will use this project without any enhancements for this exercise. 


2. From the File Menu select Open. 


3. Select From the Server at localhost (The name of your local machine is acceptable instead of localhost. 
Otherwise Select Change Server from the Server menu and change to localhost — see section 2.4). 


4. Double click on the home folder and Processes folder to display the Invoice branch. Right click on this 
branch and select Delete. 


3. Double click on the Home folder and Test folder to display the Statement branch. Right click on this 
branch and select Delete to delete the Statement branch. To delete the Test folder, double click on the 
home folder, reselect the Test folder, right click on it and select Delete. 
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TUTORIALS 


TUTORIAL PROJECT 1 


In this first project you will develop a form layout using the Developer module. All the information needed 
to carry out this project will be saved on the server in a single FormScape file called Tutor!, which can then 
be modified and updated by the Developer module for the subsequent tutorial projects 2, 3 and 4. 


In this first project you will design a simple form in the same way as in Exercise 1, but simulate adding host 
data to it by using a prepared demonstration text file (dem. ix?). 


Carry out the following steps: - 


ee 


To start Developer, click on Start/Programs|FormScape2|Developer. The Developer logo 
appears, followed by a full-screen view of the project tree in the Exploring pane. 


When you start Developer a new project is automatically started with the default name 
‘Process’, so it is useful at the outset to save your project under the name ‘Tutorl’. Do 
this by clicking on the File menu on the top of the screen, selecting Save As and then the 
To the Server sub-option. A display then shows the root folder on the Server. Click on 
the root folder (which has the default name ‘name of computer.name of domain’) and 
open the sub-folder Processes. Enter the filename ‘Tutor1’ and click on Save. 


Expand the tree by clicking on the small squares with a + sign 4 so that you can see the 
other objects connected to the tree. Note that the Process icon at the top of the tree has 
now been named Tutor1. 


The Print Queue icon is responsible for collecting the data from your host application. 
When the Server module is running it will create a shared printer in your Windows 
system called Tutor]. 


The next icon is the Language Interpreter, which takes data from the Input Queue, and 
breaks it down into pages, which are then stored in a FormScape PageBank. 


The next icon below is a folder labeled ‘On Job’, whose sole function is to hold together 
in one place all the actions you want to perform in developing this part of your project. 
It currently contains only a Print Graphic icon labeled ‘First Action’ (and its child 
objects). 


Double-click on the text label next to the Print Graphic icon (‘First Action’) and in the 
Rename dialog, change the name to 'Top Copy'. 
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4. If you have not already done so, expand the tree by clicking on the + sign next to the 
Print Graphic icon. Two further icons are now displayed — the Printer icon and the 
Reporter icon (currently labeled ‘Pages’) — that together are responsible for producing 
the printed output you require. 


D3 Click on the Printer icon and select your target printer. The printer you choose will be 
used for the form you are currently developing, but you could assign a different printer to 
— each form in your project. 


Pay 
PF is 
we 


Ee Pages Reporter 
a op Data PageBank 


 rereermeeetsret 


Lig iD) Graphic ‘Form 


| 6. Click on the + sign next to the Reporter icon to expand the tree further. Two more icons 
in are displayed — a PageBank icon (currently labeled ‘Data’) and a Form icon (currently 
labeled *Graphic’). 


| Bl i) Data /-PaceBenk 


pe fay ¢ Current Page ‘Mapper _ 
y Se Graphic! Form 


all al PageBank = input Text 





ti Click on the small square with a + sign next to the PageBank icon to expand the tree 
further. The last two icons are now revealed as a Text object labeled ‘PageBank = Input’ 
and a Page Mapper (currently labeled ‘Current Page’). These two icons control the 
PageBank: each page in the named PageBank is passed to a Page Mapper, which is used 
later on to place the host data on your form. 


i 


| 8. To start designing your form layout, click on the Form icon to open the Graphic form 
editor. This editor uses a toolbar containing many of the same tools used in standard 
Windows drawing packages e.g. you can draw boxes, add text which can be formatted, 
change fonts, line widths and styles etc. When first displayed the blank page on which 
you are going to design your form is overlaid with a page border and a grid spaced at 
inch squares, which can be used as a guide to positioning the various objects you place 
on the form. For this project you will construct a simple form with two rectangular 
boxes, some text and a graphic (the FormScape logo). 
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Click on the box tool on the tool bar and place the cursor on the intersection of the first 
horizontal gridline from the top of the page and the first vertical gridline from the left 
edge of the page. Press and hold the left mouse button and drag a rectangle that is 3 grid 
squares wide by 2 grid squares deep. Release the mouse button - a rectangle appears on 
the page. Repeat this step to produce another rectangle which is 2 squares wide and 1 
square deep, with the top left corner of the rectangle at the intersection of the first 
horizontal gridline from the top of the page and the fifth vertical gridline from the left 
edge of the page. 





Click on the text tool in the tool box, and drag a rectangle which is 7 squares wide by | 
square deep, with the top left corner based on the top edge of the page at the first vertical 
gridline from the left. This time when you release the mouse button a text editing 
window appears. Enter the word ‘Invoice’ and press the Return key. The text ‘Invoice’ 
now appears in the center of the text box. Select a font, point size and attribute on the 
top tool bar of Arial 36 pt bold for the text. 





Click on the graphic tool on the tool bar and drag a rectangle anywhere on the page that 
is one grid square in size. When you release the mouse button a file selector dialog box 
opens which prompts you to select a graphic file for entering in the box you have drawn. 
Select the file by browsing for c:\program files\Yormscape2\examplesVslogo.bmp, which 
is the FormScape logo as a Windows bitmap file. Click on Open, and the graphic now 
appears in the box on the page 


Your form should now contain two rectangles, a text (‘Invoice’) and a graphic showing 
the FormScape logo. Click on the small cross at the top right of the Form editing screen 
to return to the project tree. In the File menu at the top of the screen click on Save. 


Your blank form (i.e. the form you created in the above steps, but without any input data from 
the host system) should now look similar to the illustration on the next page. You can of course 
make a test print of the page if you wish by clicking on the Test Print button on the Graphic 
form editing tool bar, as previously done for Exercise 1. 
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Sample form layout (Tutor1) 





Page 20 


Tutorials 


So far you have set up an input queue to FormScape, learnt about some of the objects and icons required, 
selected a printer and designed a form. Now it is necessary to fill in the form with the data generated by your 
host system. For the purposes of this tutorial, a sample of data has been included to develop this project. Ina 
live situation you would capture the data using FormScape. 


Carry out the following steps: 


Queue Process xX 


oii 


ae Open File J ee eet 
Copy a sample file into a PageB ank ae 
Options gave Data 


Mh Delete tere anes when a new I 
: “‘Piocess* 
DE All PageBanks 





Antes |come| eos 





decay hi Click on the Queue Process icon at the top of the project tree to display the Queue Process 
ts dialog. Ensure that the ‘Input’ option is selected. Click on the Open a file button. Use the 
— Open Job File dialog box to browse and open the ffile c:\program 


files\formscape2\examples\dem.txt, the text file that contains the sample data. An Event 
Log window is displayed giving details about the job — 6 pages should have been loaded. 
Click on OK: you have now simulated a job arriving at the print queue. Click on OK again 
on the Queue Process dialog to close it. 


ee To fill out the form, it is necessary to be able to view the contents of the PageBank (the 
‘ input pages of data) and the form layout you have created on the screen at the same time. 
= To do this, click on the Reporter icon (‘Pages’) and click on the Map button in the Reporter 


dialog box. The screen now splits into two panes, with the input pages (Current Page) on 
the left and the blank Graphic form on the right (depending on the width of your 
FormScape display, the panes may be split vertically). The Current Page pane shows the 
first input page of data — click anywhere on it to make it active (the bar at the top of the 
pane changes color). At the top of the input page are four page arrows that allow you to 
‘flick’ through the pages (in this example there are six pages). Clicking on these arrows 
causes the data on each page of the sample to be displayed. 


41 Crown Street 


mSotchington 





a Mark a rectangle around the address block on the Current Page by clicking and dragging, 
as before. This marks a block on the input page. 


4. The toolbar at the top of the screen also shows the position of the cursor on the input page, 
measured in columns (X) and lines (Y) of the text on the page. When you select a block to 
be mapped onto your form, a text box opens in the toolbar that you can edit to give your 
selected block a name (this is the name that will appear on the tree for the block). The 
toolbar also displays the size of the selected block in columns and lines. 
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Use the right mouse button to drag this rectangle over to the Graphic form pane (the form 
layout you designed previously) and position it inside the larger of the two boxes you 
previously drew on the form. When you release the mouse button the text appears on the form. 








7. 


The text is scaled according to the size of the block on the input page, and it is probably the 
wrong size for the moment. You can correct this by moving the cursor over one of the corners 
of the block so that it changes to a double-headed arrow, and then dragging the cursor to align 
it inside the box. You may also need to change the size of the text - with the text box still 
selected, choose a font and point size e.g. Arial 14 pt which allows the data to be displayed 
entirely within the box. Click on the Left justify button on the top toolbar and click on the 
Additional Tools button to select Top to align the text vertically in the box. 


Repeat these steps using the date information on the input page and mapping it into the smaller 
box you previously created on the form. 








10. 
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To check your work, click on the Current Page pane, and using the page arrows at the top of 
the screen, flick through the input pages successively, noting that the text on Graphic form 
pane is updated each time. Check particularly that the address information is not cropped on 
some page(s) as a result of making the original mapped block too small or narrow. If this 
happens, place the cursor inside the defined block on the input page and click the mouse 
button to select the block. Move the cursor over one of the ‘handles’ of the block and drag the 
rectangle out to increase its size until the address information is correctly shown on the form 
for all the pages. If the box itself on the form proves to be too small for some pages, the text 
within it will wrap around automatically. If this happens, you can choose either to resize the 
box, or select a smaller font size to accommodate the text better within the box. 





Close the Graphic form pane by clicking on the small cross in the top right hand corner. Do 
this again for the Current Page pane, so that you now have two tree views of the project. 
Remove one of these views (it doesn’t matter which) by clicking on the double arrow at the 
top left of the view and select Remove Pane from the drop-down menu. 


Click on the File menu and select Save to save your work. (A message may be displayed that 
asks if the PageBanks should be deleted. Tick the “Don’t ask me this again” checkbox and 
click the “No” button). 
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11. You can now print (run) the job (your project) by clicking on the On Job icon with the 
i) right mouse button and selecting Run from the drop-down menu. After a short pause, your 
printer will produce six pages of forms. 


a) 12. At any time you can display a preview of the entire job by clicking on the Print Graphic 
icon (currently labeled ‘Top Copy’). A number of pages appear in preview on the screen as 


ey OF they would appear from the printer. As before, you can use the Page arrow buttons to flick 
sii through the pages, and zoom in or out on pages using the Zoom buttons. If, for instance, 

4 you repeatedly press the Zoom Out button you can eventually display a preview of all six 
| | pages of your project. 


You have now created a project and a FormScape branch file ‘Tutorl’ by mapping prepared selected sample 
data onto a form you have designed. The next tutorial project (Tutor2) uses this project and enhances it by 
adding a second or File copy of the input pages to be produced at a different printer at the same time as the 
original set of pages. 
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3.2 TUTORIAL PROJECT 2 


In this second project you will use the previous Project 1 you have just developed and enhance it by adding a 
second copy of the data, to be printed on a different printer. 


Carry out the following steps: - 


L, 
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To start Developer, click on Start/Programs|FormScape2|Developer. The Developer logo 
appears, followed by a full-screen view of the project tree. Re-open the existing Tutor! project 
and save it (to the Server) as a new project Tutor2 to make a copy of the project. Expand the 
tree using the + signs, as before. 


Use the right mouse button to drag the ‘Top Copy’ Print Graphic icon down to the add-point 
below it. When you release the mouse button a drop-down menu appears. Select Copy. A 
new Print Graphic icon appears which is labeled Top Copy 1, and is an exact copy of the 
original. If you were now to run the application as it stands, you would get two identical sets 
of prints of the job from the same printer. Rename the new icon by double clicking its label 
and changing it to read ‘File Copy’. 


Expand the tree fully for the new ‘File Copy’ Print Graphic icon by clicking on the + signs to 
the left of each icon, until you reach a Text Box object labeled ‘Text Box = Invoice’. Expand 
this branch again to produce a list of the properties (font, text attributes, color, point size) of 
this box: 


ab Font 
‘© Bold = Yes 


Italic = No 


| = | A Tost box. Involce 





| Underline = No 
aL Colour 
~ at Point Size = 36. 


Double-click on the Text object labeled ‘Text = Invoice’ (click on the icon rather than the 
label) and change the text to read ‘Copy Invoice’. Note that the Text Box object above this 
icon also changes its label to read ‘Text Box = Copy Invoice’. 


If you now click on the Form object for the File Copy branch you will see that the form is now 
headed ‘Copy Invoice’, which you have now changed to distinguish it from the form in the 
Invoice Top Copy branch (which is still labeled ‘Invoice’, as before). 


Alternatively, steps 4 through 5 could have been carried out using the Graphic form Editor for 
the File Copy directly and editing the text box to read ‘Copy Invoice’ instead of ‘Invoice’. 
The end result would be the same, but it is a useful exercise to verify that this is so, as well as 
demonstrating an alternative method. 


Tutorials 





You have now generated two sets of forms, a Top Copy set (headed ‘Invoice’) and a File Copy 
set (headed ‘Copy Invoice’), which carry identical sample data. 


7. Close the Graphic form editor to return to the project tree. 


sega: 8. To thange the printer for the File Copy set to a different destination printer, click on the printer 
Lay: icon for the File Copy branch and select an alternative printer from the available list. 





9. Save the project by clicking on File|Save, and then verify that you have now developed two 
different forms (but with identical sample data) outputting to two different printers by clicking 
on the ‘On Job’ folder with the right mouse button and selecting Run. This will cause a set of 
six pages to be printed out at both printers. Alternatively, you can click on the File Copy Print 
Graphic icon with the right mouse button, select Run, and a set of six pages will be printed out 
from the File Copy printer only. 
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3.3 TUTORIAL PROJECT 3 


In this third project you will use the previous project and enhance it by adding some conditional text to the 
set of pages i.e. text that appears on certain pages only of the sample data according to conditions established 
in the Developer module. In the exercise you will add the words ‘CASH ONLY’ to the Top Copy set, but 
only to those pages in the set of sample data that specify the payment method as CASH. The words ‘CASH 
ONLY’ are to be added as a large gray banner text diagonally across the entire form. 


Carry out the following steps: 


l. 








To start Developer, click on Start|/Programs|FormScape2|Developer. The Developer 
logo appears, followed by a full-screen view of the project tree. Re-open the existing 
Tutor 2 project and save it (to the Server) as a new project Tutor3 to make a copy of the 
project. 


Expand the tree using the + signs, as before, for the Top Copy branch, and click on the 
Form icon to display the Graphic form screen view. 


Add a Text Box by clicking on the text button in the tool bar, dragging a rectangle on 
the form that is six grid squares in each direction. Enter the text ‘CASH ONLY’ in the 
text box. Select a large font size e.g. Arial 60 pt bold and set center justification. 


Click on the Additional Tools button at the top left of the screen and select Rotation 
from the drop-down menu. Enter a rotation value of 45 degrees and click on OK. Note 
that the text ‘CASH ONLY’ is now rotated anti-clockwise by 45°. 


Select the color of the text to be gray by clicking on the color button and selecting a 
gray shade from the color palette. Click on OK. 


You now have the text ‘CASH ONLY’ in a gray diagonal (45°) banner across the form, 
but it will of course appear on every page. You now need to modify the project so that 
this banner appears only on those pages that have the payment method as CASH, and 
not on those pages with the payment method as CREDIT. The sample data includes 
examples of both types, which you can see by flicking through the input pages using the 
Page arrows. 


Close the Graphic form by clicking on the small cross in the top right-hand corner of the 
pane. 


Expand the tree below the Form icon: note that a new branch has been added at the end 
of the tree labeled ‘Text Box = CASH ONLY’. 


Using the right mouse button, click the Text Box icon labeled ‘Text Box3 = CASH 
ONLY’ and select ‘Change Type’ from the drop-down menu. 
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—y 9. A Change Object window appears: click on the Core category, and select the ‘If option. 
| If! Click on OK. Note that the Text Box icon has now changed to an If icon. Click on the 
+ sign to the left of this icon to expand the tree further. 


itil pacer ieee 
fj | if. “Text Boxa! lt 

#6) Test=No Yes/No 
oe A Yes=Cash Only Text Box 












No Form 


caeas 10. Click on the Reporter icon (currently labeled ‘Pages’) and on the Map button to produce 
Le) a split screen with the input pages (Current Page) and the Graphic form. Close the 
Graphic form window and select Close to Tree. In the Current Page pane click on the 
Page arrows to find a page with the words ‘Payment CASH’. Drag a rectangle around 
the text ‘CASH’. 
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Check that the tree displayed in the Exploring window is expanded enough to show the 
If icon and the icons below it on its branch. Use the right mouse button to drag the 
‘CASH’ rectangle across from the Current Page window to drop it on the Yes/No object 
labeled ‘Yes = Cash Only’ in the Exploring window. This object now changes to a Text 
Match object labeled ‘Test = Yes’. 
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12. Flick through the input pages of sample data using the Page arrows and note how the 
icons in the ‘If branch change depending on the input page displayed. For an input page 
with CASH, ‘Test = Yes’ appears (icon shows a green tick), while for a sample input 
page with CREDIT, ‘Test = No’ appears instead (icon shows a red cross). 





ve 


Verify that the banner ‘CASH ONLY’ now appears only on those pages with ‘Payment 
CASH’ text. This can be done by previewing the pages (click on the Print Graphic icon 
‘Top Copy’ and flick through the pages with the Page arrows). 


& 


! 


, 


D 


Lo 


Alternatively, you can print the job by clicking with the right mouse button on the ‘On 
Job’ icon and selecting Run from the drop-down menu which then appears. Two sets of 
forms will then be printed, but on some of the Top Copy set the additional text ‘CASH 
ONLY’ will be printed as a large diagonal banner. 


14. Save the project by clicking on File|Save. 
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3.3 TUTORIAL PROJECT 4 


As an extension of this project, you can now try using the Sentence object to join pieces of text 


a together and place them on the page. This can then be formatted, even though the data changes 


= from one page to the next. In this exercise, you will change the CASH ONLY text to include the 
‘Total’ field from the input page. 


Carry out the following steps: 


F 
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To start Developer, click on Start|Programs|FormScape2|Developer. The Developer 
logo appears, followed by a full-screen view of the project tree. Re-open the existing 
Tutor3 project and save it (to the Server) as a new project Tutor4 to make a copy of the 
project. 


Expand the tree for the Top Copy branch using the + signs, and click on the Form icon 
to enter the Graphic form editor view. Select the ‘CASH ONLY’ text box by clicking 
on it, and remove it from the page by right clicking on the text box and selecting Cut 
from the drop-down menu. 


Display the Exploring tree view by clicking on the double-headed arrow and selecting 
Split Vertically. (Note that the If object has now disappeared — this was deleted when 
you deleted the ‘CASH ONLY’ box in step 2). Expand the tree using the + signs. 


Click on the Graphic form editor pane, select the Text Box button from the toolbar and 
drag a rectangle on the page. Enter the text ‘CASH ONLY’ in the box that appears and 
press Enter to finish. Select a font and size of Arial 12 pt. 


On the Exploring project tree, right-click on the Text object labeled ‘Text = CASH 
ONLY’ and select Change Type from the drop-down menu which then appears. 


In the Change Object window, select the Sentence object in the Core category and click 
on OK. Note that the Text icon is now replaced by a Sentence icon: 


A ‘Al Text Box3 = CASH ONLY Text Box 
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Click on the add-point at the end of the ‘Text = CASH ONLY’ branch and select a Text 
object from the Core category in the Create Object window. Click on OK. You have 
now added a new Text icon to the tree: click on it and enter the text ‘Your invoice is for 
$’ and click on OK. 


Now click on the Text icon above it (labeled ‘First Piece = CASH ONLY’) and amend 
the text by adding a single space at the start of the text. Click on OK. (The reason for 
doing this will be apparent when the complete sentence is constructed in the correct 
order of its component items). 


Open the page mapper by clicking on the Reporter icon (labeled ‘Pages’) and clicking 
on the Map button, to produce a split screen view. Click on the double-headed arrow at 
the top of the Graphic form editor and select Close to Tree. 
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10. | Expand the tree until the add-point of the Sentence object appears. Using the scroll 
bars, position the Current Page pane so that the ‘Total’ field (bottom right-hand corner 
of the page) is visible, and drag a rectangle around the total value (make the rectangle 
wide enough to include larger numbers, if necessary). 


meses Meret a 
wm 1025.32@ 
is8 





aa 
| ed 
i 


5 





11. Use the right mouse button to drag this rectangle across to the tree in the right-hand 
view and drop it onto the add-point. 


Text = CASH ONLY Your invoice is for $... 








| mr 
Sear 
= 5 First Piece = CASH ONLY 


| $6. | Text = = Your invoice is for $ 


| =] Object = ‘Data\Current Page'Block3 


12. The sentence now has all its component parts, but the text will appear in the wrong 
order because of the way that you have assembled them on the tree. To correct this, 
click on the label of each object and use the positioning arrows to change the order of 
the objects around on the Sentence branch: - 


la) o/s) 3 = | Text = Your invoice is for $1025.32CA... 


6 Text = = Your invoice is for $ 


Object = Data\Current Page'Block3 









Hale: 
ae 66 


tT 






First Piece = CASH ONLY 


— 13. Verify by previewing the pages (click on the Top Copy Print Graphic icon). The text 
) now reads ‘Your invoice is for $XXXX CASH ONLY’, where XXXX is the sum in the 


‘iia ‘Total’ field for each page. 
14. Save the project by clicking on File|Save. 


You can now test your project by carrying out the following steps: 
1. Ensure that you save the project to the server by clicking on Save As|To the Server. A dialog box 
appears in which a folder with your computer name is displayed. Click twice on this folder to 


display two further sub-folders Actions and Processes. Select the Processes sub-folder and give the 
project the filename Tutor4. Click on OK to quit. 


2. Close down Developer by clicking on File|Exit. 


Page 29 


Tutorials 


Page 30 


Check that a print queue for the project has been created by looking in your list of available 
printers: it should now include a printer called Tutor4. 


To emulate printing your project on this printer, you need to copy the input data (the text file 
dem.txt) to the print queue, and this is most easily done using the Windows DOS Copy command. 
Firstly, copy the text file c:\Program Files\FormScape2\Examples\dem.txt to the root directory of 
your computer’s hard disk (C:). Then, using the DOS Copy command, the command: 


copy c:\dem.txt \\[computer name]\Tutor4d 


where [computer name] is the name by which your computer is recognized by your network. 
When you press Enter on the keyboard after the DOS command, the message ‘1 file(s) copied’ 
appears, showing that the file has been sent to the printer. Alternatively, you can open the Tutor4 
printer folder in your list of available printers so that it is visible on-screen alongside the DOS 
Command window. When you complete the DOS Copy command by pressing Enter on the 
keyboard, you can observe the Tutor4 print queue briefly displaying the Document Name sent to it 
before it is purged. 


Worked Examples 





4 WORKED EXAMPLES 


In this section are detailed a number of worked examples which are more complex than the tutorial exercises 
in Section | of this Guide (Getting Started). It is recommended that you work through them to familiarize 
yourself with the techniques involved for e.g. changing and moving objects on the Developer tree. Some of 
the examples require prepared sample data files which are to be found in your installed FormScape folder 
(normally C:\Program Files\FormScape2/examples). 


The worked examples are: 


Printing a banner page at the start of a print job. 
Receiving different data in one Queue Process. 
Making global changes. 
Calculating a payment date. 
Using the Page Splitter and Filter objects to position data. 
Creating a summary report of all invoices printed throughout a day. 
Determining the number of copies from the data. 
Creating a report from comma-delimited data. 
Adding headers and signatures to pre-formatted documents. 
0 Inserting the correct contact details onto an invoice. 


—OmawAA NN ABWN — 


At the end is a section explaining what happens when you save a project, how to use branches to make global 
changes to your project and how to create a generic Queue Process. There is also a section explaining how to 
convert FormScape output to Adobe PDF format. 
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4.1 PRINTING A BANNER PAGE AT THE START OF A JOB 


A banner page needs to be sent at the beginning of a job to identify who printed the document. A solution is 
to use a Binder object above the Form and Reporter objects and place details of the user and computer name 


on the banner page. 


Ql Print Graphic 


= 3 Printer = mailroom pit Printer 


veered 


a 


a) Dae “toceank 


| 


: 
| rorereereees 


a resets : 
Fe | inh 
Ay Graphic or 


i! by Invoice Print Graphic 


{i 
a 








a Printer = mailroom printer Printer 
¢ i = First Page Reporter 
aad 


4 Invoice Print Graphic 

7 41g) Printer = mailroom printer ‘Printer 
les tied Ginder 

Ly By) Form Form — 


ff tay First Page Reporter 





Text Box Text Box 





Text Box1 Text Box 





a—a—a 
erie 
> 
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| Expand the Print Graphic icon of the document that 
) requires a banner page. 


Change the Reporter to a Binder (found in the Forms category). 


Note: the Reporter will not be deleted, but will be moved below 
the Binder. 


Add a Form object (found in the Form category) under the 
Binder object and move the Form object above the 
Reporter by using the blue up/down toolbar arrows in the 
main toolbar. 


To display the User Name and Computer Name on the 
banner page, click on the add point and create two Text 
Box objects. 


Change the Text objects to User Name and Computer 
Name (found in the Container tab). 


Worked Examples 


4.1.1 CHANGING THE PAPER TRAY 


The banner needs to be printed on green paper that is held in the Upper paper tray and the invoice needs to be 
printed on standard A4 white paper that is held in the default paper tray. 


fear $e | Right-click on the Banner page Form object and 
1c | Print Graph ex Saige A ie apes. 
gg mere | oes | > change it to a Page Setup object (found in the Printing 


ht category). 


Gl} Gg) Printer = mailroom printer Printer 
paemees 2 

>); Pages Binder 

Bf) Paves Binuer 


ae Ot GEMMEMrey Pace Setup 


el {p First Page Reporter 






age setup Fae Click the Page Setup object icon to 
Ol display the Page Setup dialog box. 
Click Paper Source and a list of 
available trays will be displayed. 







You can modify the page setup for this part 
of the document 


a oes 
Options... Paper Source... 


[~ Apply to first page only 





Use the default settings for this part 
of the document 






Select the required tray and click OK twice to 


Select a paper bin or tray to take paper from. return to the tree. 
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4.1.2 ADDING PAGE NUMBERS 


We now want to add the text “Page | of x” to the Invoice, but the page number does not need to appear on 
the banner page. 





a = Test Box 





_%) Bod=No YesiNo 
{0 ven 
6) ttaic=No YesiNo 


6) Underline=No YesiNlo 


Ba) ~ 


forsee neescnene 





[ iy First display the Graphic form by clicking on the Form icon and draw a Text Box where the page 
B= number should appear and press the Enter key. Right-click on the Text Box and select Explore. 


faa coppy Now right-click on the Text object and change it to a 
A TextBoxs Text Box 





|. t le Be Sentence object (found in the Core category). 
-| (ad czy Sentence 
pet ab = Font Fort 


©) Bold = No YesiNa 


pansanran. 





‘| Text = Page 0. ‘Sentence : Q Hi | pote | & | Expand the Sentence object, click on the Text 

lend ome tne wisi object and enter the text “Page ” with a space 
| UF. | First Piece = ee Text after the word. 

an Number To Text Number To Text Then click on the add point under the Sentence 


object and select the Number To Text object (found 


Ss "32" 
Esrae 

| Lt 3 Wa eiote md co in the Core category). 

| Expand the Number To Text object and 
change the Number object to a Page Number 
container (on the Container tab). 


atest 


Se, 





| Text Box3=PageQof6 Text Box : ) | 
‘Al : 3 Click on the add point under the Sentence object and 


‘rag Text=PageQofS Sentence add a Text object. Click the Text object icon and 
ea cack enter the text “ of ” (be sure to add spaces before 
+ 4, | FirstPiece=Page Text and after the word). 








Click the Add point again and add another Number 


apes 


B- te Number To Text Number To Text 
| 


‘ie 18] Number = File Copy.PageNumber To Text object (from the Core category). Expand 
sei : this and change the Number object to a Page Count 
Ee 6 | Taste of Te Text | object (found in the PageBank category). 
Bef Number To Text Number To Text Click on the Page Count object the Page Count 
: ie dialog is displayed. Select ‘input’ from the drop- 
- ty) Number Page Count down list. 
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However, if you check the Print Preview you will see that the numbering starts at page 2. This is because the 
first page of the invoice is actually the second page that is printed. To display the correct numbering it is 


necessary to subtract | from the Page Number. 


Al Text 80x23 = Page -1 of 6 


g- Gal Text = Page -1 of 6 
fo Rae | | 
(4) Fret Pece = Pane 


(nnn nnimatim 


Number to Text 
[=] Numer 


al From = Invoice.PageNumber 


| ings 
et ee} see 
' | vrnepeiad 
i 


| 
; 
| 


[ntee tere mnae 


PETERS IE 


ews 


- 2314 | Subtract = 1 


saeereonoreone 


Change the Page Number property to a Subtract 
object (found in the Arithmetic category). The Page 
Number property will automatically be moved 
below. Click on the Number object labeled Subtract. 
Enter “1”. 


If you now check the Print Preview you should see 
that the banner page is displayed first (with no page 
number), and that the subsequent pages of the job 
are labeled “Page | of ...”, etc. 
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4.2 RECEIVING DIFFERENT DATA IN ONE QUEUE PROCESS 


2c 


Both Sales Orders and Pick Lists need to be sent to the same Queue Process and mapped onto their 
corresponding forms. We will use the Page Switch object to place the different types of data into 


different PageBanks. This example makes use of the file sopick.txt as sample data. 


Ae eaontvesnes oo06 


el) On Job Action List List 
a ee! | Page Switch fl Pane Switch 


BI @| First Action Print Graphic 





Lt 


3 oc. <| EES eee Page Syvitch 


f «| Input =Input = Text 
$s 


| 44 i Unrecognised = -Unrecognised 


=e _ Page Types 


= (te) 


Ba age ie_Libe List 


easevacne tea rdes 


Eo 


4 > 
parraend 


i 
Le 










der Number: 123 
Ate: 16/04/98 
ate: 16/04/98 


Page: 1 





First click on the add point under the On Job folder and select 
Page Switch from the PageBanks category. Move this above 
the Print Graphic by clicking on its label and using the blue up 
arrow. 


Click on the Page Switch icon to view the Page Switch dialog. 
The Input PageBank and the Default PageBank for 
unrecognized jobs are defined here, but in this example we can 
use the default values. 


Expand the Page Switch object. The Page Type folder will 
contain a list of all the different Page Types that we want to test 


Enter the text ‘Sales Order PageBank’ in the Output box. Then 
click the Map button. 


We will set up the first Page Type object to test for 
Sales Orders. Click on the Page Type object. 


The screen splits and the data is displayed in a Input Page pane along with the Exploring tree. 
Locate the text “SALES ORDER?” on the Input Page and draw a box around it. Right-click 
and drag and drop this box onto the All of object. A test is automatically set up to check for the 
defined text in that position. 
PageBank. 


Any pages that pass the test will be placed in the Sales Order 


-, 


ig Page Types Page Type List 





a Gl First Type Page Type 
: |e pad Page “Mapper 
E s fell im Tree = My Text Match 


jimecesaneaee 
seit 


gba al First = = Vnput Page'Block Block. 









) — 4) Second=SALES ORDER Text 


i : ba Output = Sales Order PageBank Text 


Bl Close the Input Page pane and rename the first Page Type object labeled ‘First Type’ to ‘Check 


for Sales Orders’. 


Click on the add point under the Page Types object and select Page Type from the PageBanks category. 
Click on the new Page Type icon and enter “Picklist PageBank” in the Output field and then click the Map 


button to define the test. 


= y Inthe Input Page pane, draw a box around the text “P IC K LIS T” and right click and drag and 
er drop onto the All of object that you just created. All pages with PICKLIST in this position will 
now be placed in the Picklist PageBank. 
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Close the Input Page and rename the second Page Type “Check for Picklists”. 


Right click on the Page Switch object and select Run. 


oc EES Page Switch ‘The new PageBanks will now be created — the results 
Ll eee) inp s Inout Test oats are listed in a Event Log window. Click on OK to 


[edd | close the Event Log window. 


; po 


i 6 _Unrecognised = Unrecognised Text 


: Tae ee 


= : Now we need to create a Print Graphic for each type 
EL ley Page Types Page Type List of document and to ensure that the data is taken from 


a4) Check for Sales Orders Pane Type the correct PageBank. Click the minus sign next to the 
oS Page Switch object to collapse that part of the tree. 


]— Tal Check for Picklists Page Type 
Tia pea 


Fess | OnJob Action List 

ae sae : = Click on the Add Point under the On Job folder. Add 
ae: <- Page Switch Page Switch another Print Graphic (found in the Printing category). 

| | oom Rename one Print Graphic “Print Sales Order” and the 


- 2 MULE 86 Print Cray hic other “Print Picklist’’. 


a Print Picklist Print Graphic 
Be cet 
Expand the Print Sales Order Print Graphic and the Reporter object underneath it. 
a Click on the PageBank object (labeled ‘Data’) and the Read PageBank dialog is displayed. Select 
ie “sales order pagebank” from the drop down list. Repeat this procedure for the Print Picklist Print 


Graphic to select “picklist pagebank”. 


The forms for both documents can now be created and the correct data will be mapped onto each form. 
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4.3 MAKING GLOBAL CHANGES 


Some objects can be reused within a Queue Process or project. So that all the occurrences of these objects 
only need to be updated once, it may be desirable to store them in a single location. The following examples 
show how this can be achieved with the Memory object, the Read File object and the Dynamic Picture object. 


4.3.1 USING THE MEMORY OBJECT TO MAKE GLOBAL CHANGES 


In the following example we will make the FormScape logo and company telephone number available. 


If we want the objects defined within the Memory object to be available to all objects under the On Job folder 
then we need the Memory object to be positioned above the On Job Folder. 


ares. 


A ay) tems  Falder 

ieee 

oa 

Pattng 

Bj Definition Action List 
: PERE : 


63 On Job Memory. 





eH ial tems Folder 


| [#]| FormScapeLogo Picture 
Ee emnent 


i PETTITT 
cae SIN Telephone Number = 01252 618600 
SPAN : ; 


; 


ios 


ta 


es | 


ay 
pat Fy Input Queue = Process 


a Fe | Language 


bla ‘On Job 
e we a tems 
| a ze) FormScape Logo 
| | ‘5, Telephone Number = 01252 618600 
cere Detinition 
319) First Action 
ig 
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Right-click on the On Job object and change it to a Memory object 
(found in the Core category). 


Next we need to add the objects that we would like to be able to 
change globally to the Items object. 


Click on the add-point under the Folder object 
(labeled ‘Items’) and select Picture (found in the 
Forms category). You will be asked to browse 
for a picture; in this example we are using the 
FormScape splash screen 
(formscape/splash.bmp). Double-click on the 
label for the Picture object and enter the text 
“FormScape Logo”. 


Next click the add-point and select a Text object 
(found in the Core category). Click the Text 
object and enter the telephone number “01252 
618600”. Then double-click on the label for the 
Text object and enter “Telephone Number”. 


These objects will now be available on the 
Container tab. 


If we expand the Action List object labeled 
‘Definition’ we can use these objects in the Print 
Graphic. 


To place the logo onto the form, expand the Print 
Graphic object, then expand the Reporter object. 


Click on the Form object (labeled Graphic) to 
enter the Graphic form editor. 


Ey To insert the Picture onto the Form click 
the Object button from the tool bar. 


Define the area on the form where you want the 
logo to appear. The Create Object dialog box 
will be displayed. Click on the Container tab. 


Worked Examples 
| 
sens das - Under the On Job object, the FormScape Logo 


_| New] @ Parameter | [9] Branch & Container | property is displayed. Select the FormScape 


Sits Logo and click OK. 
Look in object [<3 On Job | 


The FormScape Logo will now be displayed on 
the Graphic form editor in the area you 
previously defined. 





You can only see the contents of containers above this object 





cae 


A | To add the telephone number, click on the Text tool and draw a text box on the Graphic form. 
Press the Return key to leave the Text Box empty. 


ysiitanis " : Right-click on the Text Box on the Graphic form and select 
A | Text Box = 01252618600 Text Bo Explore — the project tree is displayed in an Exploring pane. 
| ee 





ho ca oeeememiccocaeauviicag CC Expand the Text Box object (under the Form object) and 
|=iee= 


right-click on the Text object (labeled Text) — select Change 
| Font Font Type. Select the Container tab and under the On Job 
busca 3 category, select the Telephone Number and click OK. 
6 | Bold=No YesiNa 


eee ements 


rat ab 


The FormScape Logo and the Telephone Number can be re-used as many times as necessary. Try changing 
one of these under the Items list and the form will automatically be updated with the new picture or text. 


4.3.2 USING THE DYNAMIC PICTURE OBJECT TO MAKE GLOBAL CHANGES 


| EI The Dynamic Picture object refers to an external location for the bitmap rather than holding the 
oes bitmap within FormScape. 


To use the Dynamic Picture object, open the Graphic form editor (click on a Form object where you want the 
bitmap to appear). Select the Object tool from the Tool Bar and define the area for the bitmap — when you 
release the mouse button the Create Object dialog is displayed. Select the Dynamic Picture (found in the 
Forms category) and click OK. You will be asked to browse for the bitmap required. When you click on the 
Open button, the bitmap you selected is displayed. 


Pe eee On the Graphic form editor, select the picture 
and right-click - select Explore from the pop- 


eeical Meee | Dynamic Picture up menu. The project tree is displayed in an 
fii Pmt Exploring pane. 


| Le Fixed Aspect = Yes YesiNo 
| joa Expand the Dynamic Picture object on the 
3) Original Size=No ‘Yes/No tree. The path that is defined is held in the 
Saco Text object below the Dynamic Picture object 
= ay Picture File = F:\formscape2.3-beta\Splash.bm. (note that the path and filename must exist on 
Ms the FormScape server). If the picture needs 
to be updated, simply replace the bitmap file 

with a new bitmap file. 
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4.3.3 USING THE READ FILE OBJECT TO MAKE GLOBAL CHANGES 


_._ The Read File object allows you to use text that is held in an external file. Therefore, if the text 
[3] needs to be changed, the file is updated and the changes are reflected within FormScape. 


First define a text box on a form using the Text tool. Press the Return key to leave the Text Box empty. 
Right click on the Text Box on the form and select Explore. 


Expand the new Text Box object and change the Text object underneath it to a Read File object (found in the 
Files category). 


Click on the Read File object and you can 
browse for the required file. In this 
example the file that holds the telephone 
number is C:\resources\telephone.txt. 





Text Box Text Box 


~ 


S Graphic Form 


a Al 
| fey Read File 
() Mea 


ies File Path = C:vesourcesttelephonetxt Text 


From now on, when the text needs to be changed, the file is updated and this change is reflected wherever the 
file is referred to within the project. 
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4.4 CALCULATING A PAYMENT DATE 


The date that the customer is due to pay the invoice by is 28 days after the invoice is printed. This needs to 
be stated on the invoice form. 


r First click on the Form object to display the Graphic form editor. Create a new Text Box on the 
| 5) form and enter the text “Payment should be made by ” (be sure to leave a space after the text). 





—{ $$. Text = Payment should be made by 


pee, ° . . ts] 
bs ab] Font Font " Payments kould de made by 
: Eiabed ms 3 : v ° : . ay . ° : ‘ . 33 
, ©) Bold= Yes Yesitlo ie 
©)! talic= Yes  YesiMo a 


ca Right click on the Text Box on the 
A Text Box = Payment should be made Be « ext Box 4, form and select Explore — the new 


Text Box object has been added 


Th az2 
ES a) Text = sRaviies should he made by 1510... Sentence under the Form object. Click on the 


plus sign to expand the Text Box 








; fay Firs Ficte | payent s should be ae by Text object. 

Gi Say| Number To Date Number To Date Change the Text object (under the Text Box 
| fr object) to a Sentence object to allow the date to 
seaeerkl Ee be added — right-click on the object, select 


Change Type and select Sentence from under 
the Core category. 


tone ceeeersewnmeas 





Pee Expand the Sentence object and 
| click on the add point. Select the 
Number to Date object (found in the 
Core category). 


saee. 
*) 


Va (rr, | Tex = Payment ae be made by 15/0... 
4, se First Piece = Payment should be mad 


aml 
‘ al4iI Add 


Next, expand the Number to Date 
object. 





Number To Date nts To Date 





Change the Number object below it 
to an Add object (found in the Core 
category). 





| ra Number To Date Number To Date , 
Bhs The arithmetic calculation needs to add 28 days to the current 


oe a Number Add i date. This is achieved by converting the date to a number, 
[4 ‘ ie adding 28 and then converting the calculated value back into a 
[ Te ca, | First Date To Number date, 
poate = 15:11:19] | 3 
is wen Tine Expand the Add object and change the ‘First’ 
4 “ote Second=0 Number | + | Number object to a Date to Number object (found in 


jad i the Core category). 


Expand the Date to Number object and change the Text object below to a Time object (also found in the Core 
category). 


By default the Time object will display the current time, but we require the current date. 
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gj Click on the Date To Number object to display the Date To Number dialog, which shows the 
234 current date formats. The Time object should use the same format so that the value is recognized as 





a valid date. 


Date To Number fee 


Select the international setting for 
the current date input: 


| English (United Kingdom) v 


Short date sample: 


25/08/98 i 


Long date sample: 


[25 August 1998 


Note: if the pear part of the current 
date input is 2 digits, then values 
between 50 and 99 will translate to 
1950 to 1999, and values between 
00 and 49 will translate to 2000 to 


2049. 
Cancel | 


| ©) Click the Time object to display the Date/Time dialog. Select the correct date format from the list 
ais and click on the OK button. 












Tine io ore Cancel 7 


International ————— 
(* System Setting English (United Kingdom) 








ee 

C3 User Setting Rriguady (United Reign) | 
i 

od 


a. Other Setting. Enalish (Linkad Kinadcrm) 


ee rere. 








Long date Me: 5 April 2000) 
Time (15:16:38) 
Abbreviated weekday name (Sat) 

Full weekday name (Saturday) wah 
Abbreviated month name (Apr) xl | 





Tip: you can create your own new formats with the sentence object. 





To finish the calculation we need to add 28 to the date value. Click on the Number object labeled 
‘Second = 0’ and enter 28. The payment date (i.e. 28 days after the current date) is now displayed on the 
form. 


A Text Box =  Paymert should be made e by 13/0... Text Box 


reewevgores 





opce od Text = Sparen should ies made by 13/0... Sentence _ 


Pearse # 2 . . - - - ° -~m@- . . . . - - ” 
pau ‘6 First Piece = Payment shouldbe made by Text bid " Payment shoud be made by 72/05/06 * 
jenny ER ERT RSe a SRV EOS Pe We OAs Eire 


=| |: Number To Date Number To Date 


aaa ety ue ss 
iS} te) First Date To Number 
Totnes 


t's oH Sees) Number 


i 

6 

| ie oe Number Add — 
| i : 
Be 

j 

| 

a 


pose 
{ 


4 ate Number To Date Number If you want to display the date in a different format, click on the Number 

I paclissinias | to Date object (this is the object that appears above the Add object on 

a | Number Add the tree). You can select a different date format from this editor by 
--— selecting a date style or language setting. 


Mea] First Date Toh 
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4.5 USING THE SPLITTER AND FILTER OBJECTS TO POSITION 
DATA 


The data below (taken from the sample data file sa/esorder.txt) shows a Sales Order that needs to be mapped 
onto a form in FormScape. There are two problems with the data that need to be addressed. First, the ‘Ship 
to’ information does not always appear, and so the Purchase Order number and following data is not in a 
fixed position. Second, the dotted lines (--------- ) should not appear on the form. 


TEST OATA LIMITED SALES OoORGQER 
PLEEI ROKOD 

AUGUSTUS EUSIWESS FRAN Ocdec Wumbec: 123 

HOOK Ocdec Date: 16e/0e/s5s Page: 

HANIS ROS1 IEP Peint Date: 16/06/58 

UNITED XIWCOON 


Sold ta: 


Bechlone Icail Holidays Attention: tica P Smith 
Tcail Howse 

34 Globe Road 

Ceawley 

Sussex 

TW23 SCH 


ship to: 


1 Ihe Koad Attention: Me C Jones 
Eciqhtan 

Sussex 

IW45 9TH 


Pucchaae Oedec: 12345 
Ceedit Ieecma: 15 


Dpt Item Wumbec Ext Peice 


2 1k3765 23/10/38 
gteé?s3 23/10/58 


1,427.66 





4.5.1 USING THE SPLITTER FOR MOVING DATA 


Load the file (click on the Queue Process icon, click on the Open a file button and select the 


LS salesorder.txt file). 
Expand the Print Graphic object , and expand the Reporter 
® First Action Print Graphic and PageBank objects. 


Change the Mapper object labeled Current Page 
a] Pages Re se | to a Splitter object (found in the PageBanks 
Seo | | category). 

a a Data PaqeBank 





Raa = inte 
ie wo ik bd mailroom “iugeae Printer 





f2,; Click on the Splitter object icon to open the 
i =e Regebank. putz. Tex HN Current Page editor in a new pane. 


= fe Current Page Splitter 





he 
L 


ee ter ee 


TW45 9JH On this pane we need to define which text decides where to split 
the page and the relative position where the page should be split. 


In this example we shall be looking for the text “Purchase Order” 


ee ee ee ee ee ee ee ee 


ee ae and will be splitting the page directly above. To split the page, 
Credit Terms: 15 ; : 

drag the horizontal red dotted line down from the top edge of the 

Dpt Item Number Due mapped page so that it is exactly above the line containing the 


fs sic sae echoes oe pends ane Sed text “Purchase Order”. 
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If we expand the Splitter object in the Exploring tree, we see that the 
a Data i POUCR page is now divided into two Mappers. 


14, PageBank = =Input Text 


Bee a The Upper Mapper will display all the information up to the line 
A | Mitac) Suite above ‘Purchase Order’ and the Lower Mapper will display 
ay pee 7 everything below. 
a @:| Upper Mapper 
MM 


Now “Purchase Order” will always appear at the 





mrurchase Croce? a7 345 eis top of the Lower Mapper regardless of the length 
Credit Terms: 15 of the details in the Upper Mapper, so the 
; Purchase Order can easily be mapped onto the 
4 pt Item Number Due form. 
1 plo987 17/10/98 


4.5.2 USING THE LINE FILTER TO REMOVE UNWANTED DATA 
Next we need to remove the unwanted dotted lines from the data. 


~=~j Locate the Lower Mapper and change it to a Line Filter (found in the Pages category). Split the 
| Exploring pane (click on the double arrow and select Split Horizontal or Split Vertical). 


Expand the Line Filter object in both panes. Click on the Mapper object labeled ‘Current Line’ 
in the left or top pane. 








THEChaSe: Order: 12345 The data is displayed with a white band on the first line of data. 
Credit Terms: 15 Move the cursor above the white line (the cursor changes to a 







double arrow ¥ ), left-click and drag the line down to the first 


Dpt Iter Number dotted line 


1 plO987 





Current Page Splitter Pau Draw a box around the first “-” and drag 
ie and drop with the right mouse button onto 

prer Mapper a the All Of object. 
| acs) med Line Fitter Now all the dotted lines will be held in the Passed 


Mapper so we only need to map the contents of the 


Current Line Mapper 
Failed Mapper onto the form. 


Gi a) First = (Current Line\Block Block 
6 Second Text 


= on | Passed Mapper 


eal Failed Mapper 


| & © Insert Blanks = = Yes YesiNo 
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4.6 CREATING A SUMMARY REPORT OF INVOICES PRINTED 
THROUGHOUT THE DAY 

A report needs to be printed at 23:00 every day to give details of all the invoices processed throughout the 
day. A Queue Process is required to collect the data and a Scheduler is also required to print the report at 


23:00. The data is taken from the sample file /nvoice.txt found in the FormScape/examples directory. In this 
example we will assume that a Print Graphic called Invoices has already been created using this sample file. 


4.6.1 ADDING THE SCHEDULER 


Both the Queue Process and the Scheduler need to run within the same thread, so they need to be defined 
under the same Process. 






Start a new project. 


4) Process List 


Right click on the Queue Process object and change it to a Process List 
prem 


object. 


ay Pau Process List Click on the add-point and add a Queue Process object. 
stb | 
ce Cc Queue Process  Gueuve Process Click on the Add point again and select a Scheduler object 


(Both these objects can be found in the Core category). 


iS Scheduler Sean, 
oh | 
4.6.2 COLLECTING THE SUMMARY DATA 


The Queue Process now needs to be defined to collect the summary data. There will probably be a Print 
Graphic that prints the invoices as the jobs arrive at the print queue. 


ea | OnJop Action List Click on the add-point below the On Job object in 


Trel Pri : Pri “fi the Queue Process branch, and add a Scan object 
'B mint invoices Eni Sraphic (found in the Core category). 


3) Scan Scan 
4 ae | 
El a Data  PageBank a 
Lo Action Action List _%?) Replace the Print Graphic object labeled ‘First 
=e Action’ with an Add Page object (found in the 
om (>]| First Action Add Page -——  PageBanks category). 


/ 








—f{i}—— 
? 
cei Be. 





s| 
° Expand the Scan object. 





i Builder — Expand the Add Page object. 
Ui $51 AddTo Text 66. Replace the Text object labeled ‘Input’ with a 
vane —" Builder object (found in the PageBanks 
FF category). 
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Add Page EW 





PageBank 
Addpagesto ence 
Invoice Summary x 


x Input ines me By 3 i pesebank 
This allows yout to add multiple pages in a single 
coer, uf tale 3 whole PageBank. 


ao Auto elete 

a 
Empty all aca p pages fom the above PageBank 
before tate new page(s). 





EF Current Page 


Click the Add Page object and 
enter the name of the PageBank 
that will hold the summary data 
(“Invoice Summary” in _ this 
example). Click OK. 


Click the PageBank object (below 
the Scan object) and ensure that 
the data will be taken from the 
default PageBank ‘Input’. Click 
OK. 


31 Click on the Scan object and click on the Map button to display the input pages. 


Click on the Builder object to display the new data page. Define the areas of data required in the 
original data and using the right mouse button, drag and drop each block onto the new data page. 
This example uses the Customer Name, Invoice Number and Total. 





=> number 


14, 11.96 
si 


Because the Autodelete flag is not set, all invoices processed throughout the day will be held in the ‘Invoice 


Summary’ PageBank. 


Close the Input pane and Current Page pane to return to the project tree. Right-click on the Scan object and 


select Run to create the PageBank “Invoice Summary”. 


4.6.3 CREATING THE REPORT 


® The report needs to be set up so that it is printed at 23:00, using the Scheduler object. Click on 
the Scheduler object and set the time of day to run as 23:00. 


Sf Scheduler Scheduler 
: Oy 


S| i) Action Action List List 5 genuet 
a a rik Gresko 


Ry Printer = mairoon ier Frinter 
3 (iQ Paces 


rorvermpereet | 





13) First Action 
ae 





a eoeries 


| 
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Expand the Scheduler object and the Print Graphic 
object below it. 





Print Graphic 


= Printer = = = mailroom printer 
zineccd | 


sere tee te ode eae e 


li Pages 


D First Action 





Printer 


‘Renoter 


'D) First Action Print Graphic 
oy 
a BMS com 


GE Of) Layout 


Printer = mailroom printer 





Layout 


® First Action Print Graphic 


a eel 





Printer = mailroom printer 


| Pages: ‘Form orm 


= BO Ei) Layout ket 
ceive a Reporter 


a Data PaqeBank 


of Graphic Binder 


li ® First Action Print Graphic 








ce 13] 


Printer = mailroom printer = Printer 
Lie a Pages Form 
a Layout Layout 


Hote 


a ea Dat PageBank 
es iy) ‘Graphic 


Form 





Worked Examples 


Change the Reporter object (labeled ‘Pages’) to a 
Form object (found in the Forms category). 


o 


Click on the Form object to display the Pages editor. 


Click the Object tool on the toolbar and draw a 
box that covers most of the page (leaving space 
at the top of the page for headings). 


oa | 
bane 


Select the Layout object from the Forms category 


paren name rmame 
) 


All 


Close the Pages form to return to the tree. 


So 


Expand the Form object and expand the Layout 
object underneath it. 


J 


‘fil 


oe ney eee 


Change the Binder object below it into a 


_.... Reporter object (found in the Forms category). 


a) 


— 


Expand the Reporter object. 


Change the Binder object below the Reporter object to a 
Form object (found in the Forms category). 


The data for the report needs to be taken from the 
“Invoice Summary” PageBank. 


Click on the PageBank object (labeled ‘Data’) and select 
‘Invoice summary’ from the drop down list. 
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hres Click on the Reporter object and click on the Map button to map across the required data to the 
fom. 


Next, shrink the page size to fit the data. 


With the Graphic from editor selected, 


Measurement Paper Size | Backaround | Zoom | Font Sizing | select Options from the View menu, click 
Bee : the Paper Size tab and click on the Shrink 
The default paper size is set by the printer to fit button. Clear the Auto-size check 
object, but you can change it by dragging the b 
edges of the form. satatagssieicrcuenreeTHE OX. 


Default | 


Set the form size ta the default paper sizer 
Ad Sheet. 210- by 297-millimeters 


eer ee wees 


shrink te fit 





Shrink the form to enclose the objects currently 
drawn on it. 


[ Auto Size 


When you open the form for editing or change 
the printer settings, t will be made the same 
size as a whole page. 





POPE RRP ENTERS CUPP AEE CTE MET ON OENEEOE SE FET ESEELOEICEIOETO REECE OTEE SE OIC OTEO IEE OE IED TOE OVECOEEOEOTIE SI ECEE TES ESTE EEO ES OE 


Return to the project tree and click on the first Form object (labeled ‘Pages’) under the Scheduler object. If 
you now Click twice on the Object block on the form (to refresh it) it will now show the data from each page 
in the PageBank. Add title and headings as required. 


_* | Invoice Summary Report 












Customer Name invoiceNumber = =———S—SséswMT gh, 





Oe ia 
Bechione TemHoHGAS , , » MMOD? , ARS 
Gann Senes . . SO. ete 
leeFrozenFoods = =, 0000000022, |, 1279.00 
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4.6.4 EMPTYING THE PAGEBANK 


Once the Invoice Summary Report has been printed the PageBank should be emptied before the new invoices 


are printed the following day. 
a Click the add point below the Action object and 


@) Sche uler Scheduler a we 2 1 | Ea} select Empty PageBank (from the PageBank 
Bgeats saa ee aRBGan 


ee 
pwede °=-* 


Poca 


eee 
oor : x 


Click on the Empty PageBank object and select 
the “Invoice Summary” PageBank from the 
drop down list. 


me Rene Ge ftintGraphic 











Gy Empty PageBank Empty Pacefiank 
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4.7 DETERMINING THE NUMBER OF COPIES REQUIRED FROM 


THE DATA 


The customer number determines the number of copies required for an invoice. If the customer number starts 


with ‘I’ there should be 2 copies, ‘F’ 3 copies and ‘R’ 4 copies. 


This can be achieved by retrieving the 


required letter from the data and using a Scan object and a Range object to create the correct number of 
copies. In this example we will assume that a Print Graphic called Invoice has already been created using the 


sample text file /nvoice. txt. 


4.7.1 RETRIEVING THE LETTER FROM THE DATA 





| i 

io | levaice 
| 

| 


Queue iain ar EE 


| Input Queue = invoice Print Queue 


ry Language Ascii 
| = $6. PageBank = Input Text 
Oo +3 en Job Memory 
one) Rems Folder 
Fae 
¢)) code text 





L 





=} io ‘Action. Action List 


3 


Gy: ek [ a First Action Copy Text 


bay 


Be ¢ ay First Action Print Graphic 


pemmiasenees of 


ooo0000001 


invoice number 
date 14.11.96 
page a 

order number  gggO456 
customer number ere i6se 


Page 50 


We need to make the letter available to 
| other objects on the tree, so first change the 
==) On Job object to a Memory object (found in 

the Core category). 


Expand the Action List object labeled ‘Definition’ 
and add a Scan object (found in the Core category). 
Move the Scan object above the Print Graphic object 
using the blue up arrow. 


Click on the add point below the Items folder and 
select a Text object from the Core category. Double 
click on the label of this object and rename it ‘Code’. 


Click on the Scan object and click on the Map 
button. The window is divided into two panes. The 
data is displayed on the Current Page pane and the 
tree in the Exploring pane. 


In the project tree, expand the Memory object and 
the Scan object. 


Change the Print Graphic object (below the Scan 
object) to a Copy Text object (found in the Core 
category). Expand the Copy Text object. 


On the Current Page pane, draw a box around the 
first character of the customer number. Right-click 
and drag and drop onto the Text object under the 
Copy Text object labeled ‘From’. 


Worked Examples 


Change the Text object below it labeled ‘To’ to the Container named Code (on the Container tab). The 
resulting tree is shown below: - 





2 OnJob Memory Right click on the Scan object and select 
is Run. The block value will now be copied 
Be Bia tems Folder | into the Code property. 
) Etaea a) 
| i Code Text | Next, change the Print Graphic 
Lennie fiprs-a ; ‘ et 
re | BS object labeled ‘Invoice’ to a Scan 
a Hitt —< object (found in the Core 
A eal] Definition Action List eecine category). 
aq Scan Scan fale ee . zi (The Print Graphic object will not be 
Ba eee Bite: | deleted, but it will be moved to the Action 


| a Data PageBank section of the Scan object). 
ae | Se _. Expand the Scan object you just created. 
Yok i al First Action cx yText : 
era aaa Change the PageBank object labeled ‘Data’ 
| la to a Range object (found in the Core 
category). 








cope af) Print Graphic 


134 invoice — Scan <==; Expand the Range object. The Start value should be set to 


ES Seta | 0 1, the Step value should be set to 1 — click on the icons to 
a 02! ay Data Ranqe change the values of these objects. 
1 : at | Start=1 Number The End number depends on the customer number code from the 
| Ta ee eee data. We shall use a Lookup object to select the correct value for the 
(| 34] Step= 1" Number End number. 





| = 

— | SAE etl Change the Number object labeled ‘End’ to a Text To Number object 
| | Current=0 Number | (found in the Core category). Expand this object and change the Text 
a ee | object below it to a Lookup object (found in the Deprecated 
A - 1@ By Action Print Graphic a category). 


{ Seal 


| 

i roa] 

Ao: 24 End Ted ToNumber ee 
[i= ) ee Next we need to define the table 


Expand the Lookup object. 





| a Gl Text Lookup nner eee eeesea are _ (Tokenizer) in the Lookup _ object. 
mae aH aes eae lb. Expand the Tokenizer object and click on 
| ce alp Table Tokenizer a one the Text object labeled ‘Text.’ Enter 
: sm Ba aa : “I=2 F=3,R=4”. Note that this is case 
| is ary Text =|-2F=3.R=4 Text sensitive. 

| ia s Delinfer=, Text | Click on the Text object below it labeled ‘Delimiter’ 


es 99 
. 


and enter 
aly é MCheee nme § 6Conisiner Shortcut 


is Finally, change the Text object labeled ‘Key’ to the 
Code Container (on the Container tab). The correct 
number of invoice copies will now be printed. 


Note: This example assumes that each print job only contains one invoice. 
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4.8 CREATING A REPORT FROM COMMA-DELIMITED DATA 


The data that we require for a report is in the sample data file speedcomma.txt and is comma-delimited, 1.e. 
each record appears on one line and the fields are separated by commas, as shown below: 


The report is divided into three sections; the first details the name, date and penalty for a speeding offense. 
The second details how the offense was recorded, town, speed and speed limit. The final section gives some 
summary information. 


4.8.1 PUTTING THE DATA INTO A BAG 


With the Delimited Data Parser and other Container objects, 
we can manage data in this format more easily. Instead of the 
incoming data being placed into a PageBank, we are going to 
manage this data via a bag. 


_ To stream the incoming comma separated data into 
a bag, change the ASCII Language object to a 
Delimited Data Parser object (found in the 
Containers category). Expand this object to 
display its child object. 


Click on the icon to check that the configuration is 
correct for our data — the Delimited Data Parser 
dialog is displayed. 


Click on the Sample Data button to load the 
sample data speedcomma.txt from the 
FormScape/Examples directory. The default 
values for the Delimiter Character, Record 
Termination and Qualifier Character options 
can be used for this example. 


The data does not include any headings to 
identify the meaning 
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oo : a Change the Reporter object (labeled ‘Pages’) to a 


} 
: i Form object (found in the Forms category). 
a ea shies 
jsomed 25 Oe rb —} 
‘ Zo ae maiiroom ance Printer 


saith 3 
| First: Action. Print Grannic Click on the Form object to display the Pages editor. 
St eee : 
pee) Bi | Printer = mailroom printer Printer Click the Object tool on the toolbar and draw a 





pany box that covers most of the page (leaving space 
Een Form ore | at the top of the page for headings). 

a fi) Layout Layout Select the Layout object from the Forms category 
Beare Sac (nN 
1) al cen port Sites Close the Pages form to return to the tree. 








is tit ‘ aa : é i OQ 
cee) Ermer mailroom printer. Printer voll Expand the Form object and expand the Layout 
nD Al Pages e Fon | — object underneath it. 
ee Al , ) Ga 
Hoh 3 On| Layo i eer . Change the Binder object below it into a 
ic of ae welt Reporter object (found in the Forms category). 


2 (a) a cone) Be 
Ca) FJ) Data Padetiank 


ies Fl Graphic Bincler 


Expand the Reporter object. 


SS] | 
3) First Action Print Graphic 
jeiee Me : Change the Binder object below the Reporter object to a 
1 Printer = mailroom printer Printer Form object (found in the Forms category). 


oh Bl Pages Aten The data for the teport needs to be taken from the 
Pes Invoice Summary” PageBank. 


pore 


E3h | ay 
= 8) Layout biel Click on the PageBank object (labeled ‘Data’) and select 
a (a) “Graphic Reporter ‘Invoice summary’ from the drop down list. 


ae a Pagebank 


— 


fx 
| i) Graphic Form 
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FFE] Click on the Reporter object and click on the Map button to map across the required data to the 
es 1 form. 


Next, shrink the page size to fit the data. 


With the Graphic from editor selected, 


Measurement Paper Size | Background | Zoom | Font Sizing | select Options from the View menu, click 
the Paper Size tab and click on the Shrink 
The default paper size is set by the printer to fit button. Clear the Auto-size check 
object, but you can change it by dragging the b 
edges of the form. OX. 


Default | 


Set the form size to the default paper size: 
44 Sheet, 210- by 297-millimeters 





Shrink the form to enclose the objects currently 
drawn on it. Lope : 


T Auto Size i ? 
When you open the form for editing or change 


the printer settings, it will be made the same 
size as a whole page. 





Return to the project tree and click on the first Form object (labeled ‘Pages’) under the Scheduler object. If 
you now click twice on the Object block on the form (to refresh it) it will now show the data from each page 
in the PageBank. Add title and headings as required. 


_ Invoice Summary Report 








Customer Name invoiceNumber == ———SSséiT gah. 






ABJonesDaiy) “°° °° * * opdoododot” = * 427900 
Bechlone Trail Holidays . . ! | . 0000000002 . | : 19345.95 
Caitwright Services. “ "=" °° * opdoododo37 = at tn, 
iceFrozenFoods © °° =~ —sndoabod22, SS 4279.00 
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4.6.4 EMPTYING THE PAGEBANK 


Once the Invoice Summary Report has been printed the PageBank should be emptied before the new invoices 


are printed the following day. 
— Click the add point below the Action object and 
12) Scheduler Scheduler | a) select Empty PageBank (from the PageBank 


category). 





BC Action Action List 


alg mz Action & Print Graphic Sas Click on the Empty PageBank object and select 
LAE tee Tas ie }; the “Invoice Summary” PageBank from the 
drop down list. 





. (@y| Empty PageBank —Emgty PageBank 
— 
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4.7 DETERMINING THE NUMBER OF COPIES REQUIRED FROM 


THE DATA 


The customer number determines the number of copies required for an invoice. If the customer number starts 
with ‘I’ there should be 2 copies, ‘F*’ 3 copies and ‘R’ 4 copies. This can be achieved by retrieving the 
required letter from the data and using a Scan object and a Range object to create the correct number of 
copies. In this example we will assume that a Print Graphic called Invoice has already been created using the 


sample text file /nvoice. txt. 


4.7.1 RETRIEVING THE LETTER FROM THE DATA 





i a = 


| C voice Queue Process : 


= ol Input Queue =invoice — Print Queue 








B P| Language Ascii 
| ara PageBank =Input Text 
ae] on Job Memory 
ic tems Folder 
| Be Code Text 
ee eg 
24a Defintion Action List 
ae Sea 
A i | Scan Scan a 
oe a Data | Pag Bank 
=| ci : Action Action List 


an ner 


$ 


Eeoey 


aman 





1 | First Action Print Graphic 
Powe 


invoice number 000000001 


date 14.11.96 
page 1 
order number ggpO456 


Customer number mrei654 
a 
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SA i ee ee 
Bu ie L First Action Copy Tex 


We need to make the letter available to 
~ other objects on the tree, so first change the 

On Job object to a Memory object (found in 
the Core category). 


hi 


ltr i 
I 


Expand the Action List object labeled ‘Definition’ 
and add a Scan object (found in the Core category). 
Move the Scan object above the Print Graphic object 
using the blue up arrow. 


Click on the add point below the Items folder and 
select a Text object from the Core category. Double 
click on the label of this object and rename it ‘Code’. 


Click on the Scan object and click on the Map 
button. The window is divided into two panes. The 
data is displayed on the Current Page pane and the 
tree in the Exploring pane. 


In the project tree, expand the Memory object and 
the Scan object. 


Change the Print Graphic object (below the Scan 
object) to a Copy Text object (found in the Core 
category). Expand the Copy Text object. 


On the Current Page pane, draw a box around the 
first character of the customer number. Right-click 
and drag and drop onto the Text object under the 
Copy Text object labeled ‘From’. 


Worked Examples 


Change the Text object below it labeled ‘To’ to the Container named Code (on the Container tab). The 
resulting tree is shown below: - 


ey On Job: Memory ae ee ee 7 Right click on the Scan object and select 
ele e me pial Run. The block value will now be copied 
ce 2 lial & Items ‘Folin gee | | into the Code property. 


Next, change the Print Graphic 
object labeled ‘Invoice’ to a Scan 
Eau ees ennai | ) object (found in the Core 
f) Definition Action List 2 } | category). 





<> pasenswssanennens 


: Be z1 | Scan ‘Scan acai ul | 7 (The Print Graphic object will not be 
‘ oes ae 3 aati deleted, but it will be moved to the Action 
AO B 2 PageBank eerie section of the Scan object). 


Sl fal Action Action List 


: pth ee 
ele a First Action Copy Text 
Ui yam resets se ce see fe 2 Change the PageBank object labeled ‘Data’ 
freee ULE Pe EN CUS to a Range object (found in the Core 


| - a ae To = On Jab Cote Containersh  °a!eB0ry)- 


Expand the Scan object you just created. 





pee 
Sis ¢ 


ee GS) TEE Print Graphic 


| $1 | Invoice Scan : coosy . Expand the Range object. The Start value should be set to 
jim 03 1, the Step value should be set to | — click on the icons to 
~~“ change the values of these objects. 





foe 


EI 3 Data “Renae a 


3 
[er oe 
ae =. i] Stat=1 Number The End number depends on the customer number code from the 
op data. We shall use a Lookup object to select the correct value for the 
: FE joe oi ‘Step = 1 Number End number. 
_/9y| End=0 Number 
— | zag Change the Number object labeled ‘End’ to a Text To Number object 
a 314 ait) Current = 0 ‘Number (found in the Core category). Expand this object and change the Text 
a} object below it to a Lookup object (found in the Deprecated 

‘ |) Action Print Graphic category). 

js Expand the Lookup object. 





a 2 End Text To Number 
ee Next we need to define the table 
1 Ey) Text shes Eeaitihe (Tokenizer) in the Lookup _ object. 
at | lb] Expand the Tokenizer object and click on 
a alo Table Tokenizer aan the Text object labeled ‘Text.’ Enter 


fe an “T=2 F=3,R=4”. Note that this is case 
ae Text=Ie2F=3.R=4 Text sensitive. 
| 1%, Deimiter=, Text Click on the Text object below it labeled ‘Delimiter’ 
a and enter “,”. 


Ee é& Key = On Job.Code Contain ier Shortcut 


sii Finally, change the Text object labeled ‘Key’ to the 
Code Container (on the Container tab). The correct 
number of invoice copies will now be printed. 


Note: This example assumes that each print job only contains one invoice. 
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4.8 CREATING A REPORT FROM COMMA-DELIMITED DATA 


The data that we require for a report is in the sample data file speedcomma.txt and is comma-delimited, i.e. 
each record appears on one line and the fields are separated by commas, as shown below: 





1/06/98, camera, High Street, Aldershot, Alex, Wright, 43,3 
0/06/98, camera, 431, Alton, Stuart, Malt,90,70,3 penalty 
3/07/98, officer, A30, Basingstoke, Karen, Fuller,85,70,6 






The report is divided into three sections; the first details the name, date and penalty for a speeding offense. 
The second details how the offense was recorded, town, speed and speed limit. The final section gives some 
summary information. 


4.8.1 PUTTING THE DATA INTO A BAG 





Ce | Nortel Queue Process With the Delimited Data Parser and other Container objects, 
spat | we can manage data in this format more easily. Instead of the 
fa s} Input Queue =Normel Print Queue —_ incoming data being placed into a PageBank, we are going to 


Litas EU manage this data via a bag. 
A e Language Delinited Data Parser 


Fig ic | Container Bag To stream the incoming comma separated data into 
ames ‘cri a bag, change the ASCII Language object to a 
G— 6) OnJob Action List tf ~~ Delimited Data Parser object (found in the 
FOP ie Containers category). Expand this object to 

BH & First Action Print Graphic display its child object. 
rad [sa] Click on the icon to check that the configuration is 
EB"; correct for our data — the Delimited Data Parser 

dialog is displayed. 
Sab ohn one spac Reg 
1 


cee sample data speedcomma.txt from the 

oS DOL Semler ane ote FormScape/Examples directory. The default 

"EB" Sample Data | values for the Delimiter Character, Record 

Define the chusctenstics of the debited das Termination and Qualifier Character options 
7 can be used for this example. 





@ Comma € Tab © la! ae 








The data does not include any headings to 





Record Termination: - See ae aa RES eee eee identify the meaning of each field (column of 
| © Catiage Retun Line Feed {13+10) C Line Feed (10) at BY a each bss is named 
ieldl, Field2, and so on. It's good practice to 
| & Caniage Retum (13 C Fids Per R c: fe : 

Ebel fe pera SRE change the headings to something more 
r dG cinet Cheeslere= = eee ee intelligible. The benefits of this will become 
Lc Speech Marks c fonre Wl c © Other: | apparent when mapping data later. Click in 


the column in the table of data and changing 


[~ First Record Contains Field Navel its name in the Fieldname text box. 


Fieldname: a I 


Date Method [aie : : Rename: 
Ha Fieldl to Date 


Field2 to Method 
Field3 to Road 
Field4 to Town 
FieldS to Forename 
Field6 to Surname 
Field7 to Speed 
Field8 to Speed Limit 
Field9 to Penalty 
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When the changes are made, click on OK to close the dialog. 


o 


icon. 


=}-¢3) Root 
=} RECORDSET 
= (9) RECORD 
/ in §$. Date : 21/06/98 
*$, Method : camera 
*$, Road: High Street 
*$, Town: Aldershot 
*$, Forename : Alex 
*$, Sutname : Wright 
*$ Speed: 43 
"39 Speed Limit : 30 
--*$, Penalty : 3 penalty points £40 fine 
2 -(C] RECORD 
(3 RECORD 
(2) RECORD 
© RECORD 


4.8.2 CREATING THE REPORT 


GEE} 


g First Action Print Graphi 


ig ae So 


me 


8 |] Layout Layout 








MitGc@a enue Printer 


Pages Form 


a fl Graphic Binder 


A First Page Text Box 


arte 


a 
G)— 





| B Pages Form 


oe al) Layout Lavout 


soe reereece: 


“Fist Bection Headings Form 


‘First Section Reporter 
Section Section Headings Form 


Second Section 


iced = Form 


Reporter 





To fill the bag using the current configuration, click on the Queue Process object and click on the 
Open a file button to import speedcomma. tt. 


The Delimited Data Parser child Bag object is now filled and can be viewed by clicking on its 


The bag should now look like the illustration opposite. 
There are 5 records. The first record has been expanded so 
that the child field names and text values can be read. 


The bag is exposed by the root Queue Process object, so 
when it is needed later in the project branch, rather than 
potentially large amounts of data being passed from object 
to object, a reference can be made via the Container 
Shortcuts. 


Return to the project tree by closing the Container pane. 


: 


& 


| 
} 
L 


Expand the Print Graphic object. 


Change the Reporter object (labeled *Pages’) to a 
Form object (from the Forms category). 


outed 


Click on the Form object to open the Pages form 
editor. Use the Object tool to define an area on 
the form that is the same size as the page. 


ia 
. 
! 
. 


When the Create Object dialog box is displayed, select the 
Layout object from the Forms category. Return to the 
project tree. Expand the Form and the Layout objects. 

| A Delete the Text Box object below the Binder 
ee object. 


Click on the add-point below the Binder object and add a 
Form object and a Reporter object (both found in the 
Forms category). 


Add a second Form and Reporter object, and then add 
another Form. Label these according to the section of the 
report they will create (as shown in the snapshot to the 
left). 


We will now look at creating each section of the report in 
turn. 


Page 53 


Worked Examples 


4.8.2.1 FIRST SECTION OF REPORT 


Click on the First Section Heading Form object 
and define the headings as shown to the left on 
the First Section Headings form, using the Text 
tool. 





Speeding Report 


Name Date Penalty 





Select Options from the View menu and select the Paper Size tab. Click the Shrink to Fit button and uncheck 
the Auto-size check box. Close the First Section Headings form editor pane to return to the project tree. 


Next, expand the Reporter object (labeled ‘First Section’). 





i el : EH iene manent ti es The first child object (labeled ‘Data’) specifies 
p> {a First Section Reporter what data to loop round. Change this Data 
fel aa abeate dlidaete object from a PageBank object to a Walker 


Bal cu Data. Walker | object (look under the Containers category). 


ieee 7 ee tpeeeee 
dees & Lee See ey § Contsine! Expand the Walker object. 


The Bag child object of the Walker specifies at what level in the bag's data structure it is to loop through. 
Right-click on the child Bag object and go to the Containers tab, where a Container shortcut can be specified. 
We need to loop round all the children under the RECORDSET folder, so select RECORDSET from the tree. 





Click on the First Section Reporter object and click on the Map button. The screen splits into two panes-the 
Data for Graphic data palette and the Graphic form. 


Map across the Surname, Forename, Date and Penalty description to the top of the form, by dragging and 
dropping the relevant fields from the Data for Graphic pane (using the left mouse button). 


)-@y Value 
~~, Date 21/06/98 
BS, Method camera 
—&, Road High Street 
&_ Town Aldershot 





Note: You can check the appearance of the report by opening the original form (i.e. the Form object just 
below the Printer object). 


Next, select Options from the View menu and select the Paper Size tab. Click the Shrink to Fit button and 
uncheck the Auto-size checkbox. 


Close both panes to return to the project tree. 
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4.8.2.2 SECOND SECTION OF REPORT 


= Open the Second Section Heading Form editor and 
Method = Town Speed SpeedLimit define the headings shown alongside. 
Select Options from the View menu and select the Paper Size tab. Click the Shrink to Fit button and uncheck 
the Auto-size check box. Close the form and return to the project tree. 


Next, expand the Reporter object labeled ‘Second Section’. As in the First Section, change the Data object 
from the PageBank to a Walker and specify the RECORDSET as the Container Shortcut. 


Click on the Reporter and press the Map button. Map across the Method, Town, Speed and Speed Limit to 
the top of the form. Next, select Options from the View menu and select the Paper Size tab. Click the Shrink 
to Fit button and uncheck the Auto-size check box. Return to the project tree. 


4.8.2.3 CREATING THE SUMMARY SECTION 


The summary section will contain the sentence “This report contains x speeding offenses, y were caught by 
cameras.” The values x and y need to be defined and will be calculated by building a branch that counts bits 
of the data. This can be achieved by using a combination of the Memory, Scan and Add objects. 


Change the On Job folder to a Memory 


|| Onvob Memory 
oS Ls a object (found in the Core category). 


pre ereeeeres ener 


Fx 
Fl (ej, Mems Folder 


Click on the add-point under the Items folder 


oe 

















— 314 TotalRecords=0 Number and select a Number object from the Core 

oo category. Rename the Number object as 
= 3144. CameraTotal=0 Number “Total Records”. Add a second Number 
a object, this time labeling it "Camera Total”. 
se These will be used as counter objects. 

B BR | Defintion Action List Expand the folder labeled Definition and add 
ae : a Scan object (found in the Core category) 
Er it scan Scan under the On Job folder and move it above 

eee =r the Print Graphic using the blue up arrow in 

| re Data Walker the toolbar. 

i satroab tats 

|| oe : | | 

| | ee nL PADS GEGORESE ets Change the child Data object under the Scan 
ee ace li Acton (Abhon lish object to a Walker (under the Containers 

| ie Hue paca: au : category) and it's child object, Bag, should 

BQ) First Action Print Graphic pS etieeen reference the RECORDSET Container 

Firetree THMen UMM noe eereee uuu 


Shortcut. This again highlights to loop round 
all the child folders of RECORDSET, i.e. 
Loop round each Record. 


We have specified what we want to loop round, next we must define our calculations under the Action folder. 
The first, and simpler of the two calculations is the total number of offenses. 
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On the add point under the Action List object (labeled ‘Action’), add a Copy Number object (look under the 
Core category). The Copy Number object will be a counter, which will increase by one each time the scan 
loops around. Expand the Copy Number object to display two Number objects. 


Change the first Number object labeled ‘From’, to an Add object (found in the Core category). Expand the 
Add object. 
We are going to add one to the counter, Total 


a Action Action List Records, which we defined under the Memory 

object earlier. Therefore, change the First 

a % First Action Print Graphic number (under the Add object) to reference this 

= “Total Records” object by right clicking and 

= : all Copy. Number: Copy Number selecting Total Records from the Containers tab 
| Bee (under On Job). 


B+ From Add 


ae 


: zs ry First = On Job Total Records Container She Click the Number object labeled ‘Second’ and 


i 
| 
pio SP si biad enter |. 
| 3 Kia Second=1 Wumber 

sash Change the Number object labeled ‘To’ to the 
| Container Shortcut Total Records Container Shortcut. 








| To = On Job.Total Records 





We are now incrementing the value ‘Total Records’ and putting the result back into ‘Total Records’. This 
will occur five times in this example. As this Scan is placed higher on the branch than the Print Graphic, the 
Total Records counter will reach 5, when it will be used by the Summary section of the Print Graphic. 


The second Action we need to define involves calculating the number of offenses picked up by the speed 
camera. In much the same way as calculating the Total Records, we use a counter system, however, this time 
it is only incremented if certain conditions are met, i.e. “Is the Method element's value ‘camera’?”. 


| > Create a second child under the Action object of type Decision (look under Core) and expand the 
. new object. A Decision allows us to run an Action if a specified test returns ‘Yes’. The test will 
be a Text Match of the text "Camera". If true (Yes), we increment the Camera Total counter. 





o— This is achieved by changing the All Of 

Bare Decision Decision object labeled ‘Trigger Tree’ to a Text 
Saale eee ; Match object (look under Core). 

= oe Trigger Tree=Yes Text Match 

Too Its first child (a Text object) should be 

— ay First = Scan. Method Container Shortcut changed to the Container Shortcut, Method. 

— This is accessible from the Containers tab in 

| By second = Camera: Text the Change Object dialog (select Scan from 


i 
i 


Eoin Ree) ; the Look in object combo box). 
oer By When Triggered Copy Number 


The second child of the Text Match object 


—+ | From. ad should be the word “camera”. 


leach a ete sie 3 
~ | First = On Job.Camera Total Container St We now need to specify what happens if we 


find a “camera” record. In a similar vein to 
the Total Records case, we increment a 
‘ot | Tore eee hRae? counter. This time the Camera Total 
feta se ARE counter. 


= at Seen een Number 


Change the Action list object labeled ‘When 
Triggered’ to a Copy Number object and 
follow the instructions as before for the 
Total Records, remembering to reference 
the Camera Total instead. 
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Finally, we need to ensure that the value of both counters are reset to zero before the Scan is run. Add 
another two separate Copy Number objects above the Scan object which copies the value zero into the Total 
Records and Camera Total container shortcuts. To achieve this, add the objects to the add-point and use the 
blue arrows tools to move the objects up the tree. 


irl Definition Action List 
ies Seana 
a a Copy Number1 Copy Number 


i 34] From=0 WNurmnber 





— cB | To = On Job. Total Records Container Shortcut 


ae me ewed 





A | Copy Number § Copy Number 

a mae 314 | From =0 Number = 

| Ly ey To=On Pay) Camera Total Container Shortcut 
| epost ines 

a |g | Scan Scan 

i] = sm 

om {B,| First Action Print Graphic 

Pb 

es 


The final section of the report can now be created. 


Open the Form object labeled ‘Summary’, and draw a Text Box. Enter the text “This report contains ”, with 
a space at the end of the text. Right-click on the Text Box and select Explore. Expand the new Text Box 
object on the tree and change the Text object to a Sentence object (found in the Core category). Expand the 
Sentence object. 


Click on the add-point below the Sentence object and select the Number To Text object (found in the Core 
category). Expand this Number To Text object and change the Number object below it to the counter, Total 
Records, container shortcut (in Change Object look under the Containers tab and under the On Job in the 
Look in combo box). 
Add a Text object to the Sentence and enter the 
oe S Summary text “ speeding offenses ”, with a space at 
: either end of the text. 


ce 


oe A Text Box = This report contains 0 ‘Speedin:,. 


Add another Number To Text object (in the 
Core category) under the Sentence, expand it 





A A —| a cr Text = This report canteins 0 Speedin... 
i 
{ 


__/'66'| First Piece = This report contains and change the Number object below it to the 
pean 3 counter, Camera Total container shortcut (in 
| on" Number To Text Change Object dialog, under the Containers tab 
4, faerareaipG oneness and under the On Job in the Look in object 
99 combo box). 


a eal Number To Text1 





= Add a final Text object with the text “ were 
ken Text! = were caught by cameras caught by cameras.” with a space at the 
Te beginning of the text. 


ROSE Se On 


LORNA INIA OIA AAD AAN DSDNA AMANO Aan ed Nl re 


Finally, click on the Summary form editor (to 
enable it) select Options from the View menu 
and select the Paper Size tab. Click the Shrink 
to Fit button and uncheck the Auto-size check 
box. 


The report is now complete. 
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Speeding Report 


Neme Date Penalty 
Yvrignt ALEX ZIMESIC 3 penalty pots £40 fine 


Stuart 3006993 3 penalty ports £60 fine 
Fuller Karen 03/0798 § penalty poirts and 1 yer ban 
Cassidy Steve 08/07/98 5 penalty paints and & manth ban 


Weight Mick OFS B pensity points and court ackwon to tallow 


Method Town Speed Limit 


camera Aldershot 4g 30 
camera Altan 90 7a 
officer Basing stoke a§ rat) 
Camera Fleet 4§ 39 


ofiicer alton 7§ 50 


This tepert contains 3 speeding offences 3 were cought by caverta: 
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4.9 ADDING HEADERS AND SIGNATURES TO PRE-FORMATTED 


DOCUMENTS 


FormScape can be used to add headers and signatures to documents that do not need any other processing i.e. 
the format of the document is already suitable for printing. For example, users could produce a letter in 
Microsoft Word and use FormScape to add the company letterhead or their signature. 


4.9.1 CHANGING THE PRINTER DRIVER 


Pant Queue x 


Print Queue 





IV Use Queue Process name 


[ Document Defaults —_—— 


- Preferred Driver [HP Lasewet 6L | 


| Tip: you can enter a partial driver name, and 
_ FoimScape will choose the closest matching name. 


Da cieap atypia pepper i fl ANA NNO attain ty 


| Paper Size | Ad Sheet, 210- by 297-millimeters nai 
| Orientation 


* Portrait Landscape 





4.9.2 ADDING THE OVERLAY CHOOSER 


ae | Promess Queue Process 
J Input Queue = Process Print Queue 
El eal Language - Overlay Chooser 


dansdarmacereedd 


a ay) Overlay List Overlay List 


arenes 








1) Printer = Hewlett Packard LaserJet 6L —Erinter 


o- aa} On Job - Action List 


&}| Gy| First Action Print Graphic. 





— 





Create a new Queue Process. 


The first consideration is the Printer Driver. 
By default FormScape will use a Generic/Text 
only driver, but for this Queue Process we need 
to use the Printer Driver for the final 
destination printer so that Microsoft Word uses 
the correct settings for the document. 





To change the printer driver, click 
on the Print Queue object and enter 
the name of the printer driver into 
the box labeled ‘Preferred Driver’. 


The Paper Size and Orientation defined here 
determine the document defaults of the printer 


that is created. 


Click OK to return to the Project tree. 


coca Change the Language object to an 


: cB | Overlay Chooser object (found in the 
“Printing category). 
Expand the Overlay Chooser. The 


Overlay Chooser has a list of Overlays 
and a Printer object where the output is 
directed. 
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4.9.3 CREATING THE LETTERHEAD 


First, we will setup an Overlay Choice to print a letterhead. 





Overlay Choice 


[@lettethead® 3 K 
Macro ID (221 3] | 


IV Remove trigger 


Trigger 


Cancel. 


Al 


[” Relative positioning 





4.9.4 CREATING THE SIGNATURE 


Rename the Overlay Choice object (labeled ‘First Overlay’) to ‘Letterhead’. 
Overlay Choice object to display the Overlay Choice dialog. 


Click on the 


Change the trigger to “@letterhead@” and click on 
the OK button. The Overlay Chooser will check 
the data for this text and if it is found it will be 
removed from the data and the letterhead defined 
in the form below will be printed. Note that the 
trigger must use a printer resident font (such as 
Courier) to be recognized. 

ce! Expand the Overlay Choice object and 
click on the Form object to design the 
letterhead. 


Next we will add an Overlay Choice object to place a signature on a document. 


Overlay Choice beg 
Trigger [@signatue@ evoke | 
Mecto ID (221 32 


IV BEI tose 


Cancel | 





Fee 
ta Process Queue Process 





Pee re 


2 @ 





Input Queue : = Process - Print Queue 


Language Overlay Chooser 


4 ~ [eyo eveiey List 
| ab }| Letterhead Overlay Choice 
ae Signature Overlay Choice 
| [ith awe) 

Lig 





Poon 
ra. Fe 


pa) 


| 

| 

A Ld) On Job 
To 


Printer = mailroom printer —- Printer 


— 








Action List 
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Click on the add point below the 
Overlay List object and select Overlay 
Choice (in the Printing category). 
Rename the Overlay Choice object 
“Signature”. 


& 


Click on this Overlay Choice object and change 
the trigger to “@signature@”. Select the Relative 
positioning checkbox, because the signature does 
need to appear relative to the trigger. Click OK to 
return to the project tree 


Expand the Overlay Choice object and click on the 
Form object to define the bitmap of the signature 
using the Picture tool on the Form editing toolbar, 
importing a bitmap with a scanned image of the 
required signature. 


Now all print jobs that arrive will be checked for 
the defined triggers. Regardless of whether the 
triggers appear or not, the print job will be sent to 
the printer (the mailroom printer, in this example). 


Note: The Print Graphic object that is under the 
On Job folder can be deleted because it will not be 
used. 


Worked Examples 


4.10 INSERTING THE CORRECT CONTACT DETAILS ONTO AN 
INVOICE 


The contact details (name and telephone number) that need to be displayed on an invoice are different 
depending on the customer number. Each customer number starts with either an ‘I’, ‘F’ or ‘R’. We shall 
look at three different methods of achieving this by using either the Chooser, Lookup or Read File objects. 
These examples use the sample data file /nvoice. txt. 


For each of these examples we need to open the Invoice Queue Process (invoices.fsp) and expand the 
‘Invoice’ Print Graphic object. Click on the Reporter object and click on the Map button. The screen splits 
into a Graphic form editor and Current Page layout. 


On the Graphic form editor, using the Text tool, define a text box for the contact details on the 
form and press the Enter key to leave the text empty. Right-click on the text box and select 
Explore to locate the Text Box on the project tree. 


4.10.1 THE CHOOSER OBJECT 


A Expand the Text Box object and change the Text object below it to a Chooser object (found in the 
I. Core category). 


¥ Expand the Chooser object and expand 














Al Text Box23 = Contact Jo Bloggs on 0345 6666... sie the Choice object below it (labeled ‘First 
aie es oe Py i Choice’). 
a | Fy Text chooser Lith 
data from the sample file (click on the Reporter 
a 2% ae | First Choice = Choice object) and draw a box around the letter ‘F’ at the 





aoS-ngincset 


Fa aay l ies beginning of the customer number (on the Current 
H— = Test=Yes fe c Page pane). 


fej Vue = Contact o 30005 Oa 
ol ales Ee e) Right-click and drag and drop onto the 
uae aa (= Yes/No object — the icon changes. 


eb veeserweneetse | 


x : 

ae al fay Choices Choice List iS Ensure that you are displaying the first page of 
; 

hon 


+) Otherwise Text Click on the Text object icon labeled “Value” and 

| enter the text “Contact Jo Bloggs on 0345 666666 
with any queries”. 

| A Text Box23 = Contact John Smith on 0345 777... TextBo; | poe 

ees Click on the add-point below the Choice List 

cope ile Text Chooser object and add another Choice object (in the Core 

i= 

| 


ui ae category). 


f ee ated First Choice Bia Expand the new Choice object and move to page 2 
=| 24 | Choie 


of the data (click on the Current Page pane to 


cf 
| 
| | cs Test=No Text Match select it and click on the right arrow button). 

| | eg ee rane uag anes 

fea eee *$. Value = Contact Jo Bloggs on 0345 Right-click on the box you drew earlier (it now 
pear ete contains the letter ‘I’) and drag and drop it onto the 


: | / : . : 
A ea Choice Snoice new Yes/No object. 





¥— Test=Yes Text Match 
| Tests Yes Text Maten Click the Text object labeled ‘Value’ and enter the 


| 
| | la $$ | Value = Contact John Smith on 0345 ‘text “Contact John Smith on 0345 777777 with any 
| ped See queries”. 
| 
| 


Now click on the Text object labeled “Otherwise” 
and enter the text “Contact Sarah Jones on 0345 
888888 with any queries”. 
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The correct contact details will now be inserted on the invoice, depending on the first character of the 
customer number. 

4.10.2 THE LOOKUP OBJECT 


(Before trying this exercise, be sure to re-open the invoices.fsp project, reload the file and recreate the text 
box). 








Expand the Text Box, and change its Text 
object, labeled ‘Text’ to a Lookup object 
(found in the Deprecated category). 


Text 





-|F=Contact Jo Bloggs on 0345 666666 with any queries 
l=Contact John Smith on 0345 777777 with any queries 
R=Contact Sara J 0345 888888 with l CIEE 
ontact s4fa vones on with any quernes | Expand the Lookup object. 


Fon Expand the Tokenizer object below 
vale] it 


Click on the Text object labeled ‘Text’, and 
enter the three lines of text displayed to the 
left. (To start a new line of text, hold the 
Control key when pressing Enter). 


@ DecC Hex M Mutiine [| OK | Cancel | 


By default the Text object labeled ‘Delimiter’ is set to a carriage return and line feed, so these options do not 
need to be changed. 


In the Current Page pane draw a box around the letter ‘F’ at the beginning of the customer number on page | 
of the data. Right-click and drag and drop onto the Text object labeled ‘Key’. The correct contact details will 
now be inserted onto the invoice. 


4.10.3 THE READ FILE OBJECT 


For this example we need to create a directory on the C drive called “contacts” and three text files called 
F.txt, I.txt and R.txt respectively. Each text file should contain the appropriate contact information e.g. 
‘Contact Jo Bloggs on...’ in the F.txt file, ‘Contact John Smith on...’ in the I.txt file, and so on. 


Expand the Text Box object and change its Text 


7 A Text Box23 Text Box object to a Read File object (found in the Files 


B (el) Text ReadFile Saree Or): 
pote : 
| a+ a) File Path = c:\contactsFixt Sentence —" Expand the Read File object and 


change the Text object below it 
labeled ‘File Path’ to a Sentence 
object (found in the Core category). 


TRI 
| Heisit iy ie a 
| J 5 First Piece = c:icontacts\ Text | 


| ee 


| &J|_ Object = ‘Deta\current Page'Block16 Block 
j 4 





EEE 


Click on the Text object below the Sentence 
object labeled ‘First Piece’, and enter the text 
“C:\contacts\”. 


Draw a box around the letter ‘F’ at the beginning 
of the customer number on page | of the sample 
data, right click and drag and drop it onto the 
Add point below the Sentence object. 


Finally, add another Text object to the Add point 
and enter the text “.txt”. The correct file will 
now be selected for the invoice. 
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4.11 USING BRANCHES 


4.11.1 USING BRANCHES TO MAKE GLOBAL CHANGES 


It is possible to save any object as a branch. If you right-click on any object you will be given the option to 
Save either ‘To the Server’ or ‘To My Computer’. Once an object is saved to the Server, the branch will 
become available if you change the type to a compatible object (using the branches tab). In the following 
example we will create a branch holding the company address and then reference the branch rather than 
retype the text on every form. 


a 


(2 


xz. L dt) 
| 314 


| s 
' 
ADs 
lake 


A Company Addisss = AFR: Resch Hous 


Text = AFP Beech House Ancell: 
Font. Fort | 


Bold =No Yesin 


talic=No  YesiNo 


Underline =No esi. 
Colour Colour 
Point Sizeé=10 Wumber 


rn 


ee 


| meetin 


Start a new branch in FormScape Developer. 
Change the Queue Process object to a Text Box 
object (found in the Forms category). 


Expand the Text Box object, click the Text object and enter 
the company address (hold down the Control key and press 
Enter to move to a new line). 


x 


Right-click on the Text Box object, select Save As 
from the menu and select To the Server. Create a 
new folder called Shared Resources and click on 
the Save button. In this example, the branch has 
been named ‘Company Address’. 


Next we need to use the company address branch within our 


project. 


Open a project where the company address is required. Expand the Print Graphic and Reporter 
objects, and click on the Form object to open the Graphic form editor. 


Select the Text Box tool and define the area on the Form where the address should appear. Press the Enter 
key to leave the text empty. Right-click on the text box and select Explore to locate the Text Box on the 


project tree. 


Right-click on the Text Box object, and select Change Type. 


Click on the Branch tab and go to the Shared Resources folder. 


Double-click on the Company Address branch and the file is added to the project tree. 


Text Box21 = Invoice Number 


Text Box22 = Customer Number 





Text Box 


Text Box 





Text Box23 = Shared Resources\Company Adare... 


Branch Shortcut 





You can use the same procedure to reuse the company address branch in any project. If the company address 
changes, simply open the Company Address branch and make the changes. When the branch is saved the 
changes will be effective wherever it is used. 
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4.11.2 USING INPUTS 


It may be desirable to use different point sizes for the company address at different locations. To achieve this 
you need to setup a Parameter. 

Open the Company Address_ branch 
created above. 


a4 


ER ORG Were Ditto ne 3 


Right-click on the Number 
object labeled ‘Point Size’ and 
select Change Type from the 


rat; 


as Number [in] 





34 Ve fee menu. 
— Divide 


SEE ete Document Field : : 
See A alt % Click the Parameter tab. Click the New 


button. Ensure that the Type is ‘Number’ 
and change the Name to ‘Point Size’. 
Click OK twice to return to the tree. 


Yoacnewert et obits preahet eee! 
~~ roaerd 


eos 8 39 a 







The Number object will now appear as a Parameter 
object on the tree. 


eae ee 


» iS 
ag er a nen > 
~ 
sae ee 
SR ae ee 


aes 
$48 


BN PVN PYAAR 


— If you want to set a default value for the Point Size, 
Parameters : 

Pveinihaahacescsnceiet . —7 A! click the Parameters tool on the toolbar to open the 

3 ig Schott eee: Parameters editor. 





Select Point Size and click the Edit Default Value 
button. 





Enter the required value (0 in this example) and click on the OK 
button. 


Click on the EI in the upper right corner to close the Parameters 
window. 


= LT UMANATCR ninpATRR Select Save from the File menu to save the 
2= Customer Numbert ii TextBox. iki: changes. 


Now open the Queue Process branch where 
eee ue eu a fi, the Company Address branch was been used. 
: Biota eG: AUVs Bone Rises Hiss Locate the branch in the tree. 


peas 





Click on the branch and then click OK (this is 
to refresh the branch). The branch will now 
have a Number child object. Enter the required point size into the Number object. 


A second parameter could be defined if, for example, the color of the text was to change according to the 
location. Follow the same procedure as above to create the color parameter, not forgetting to refresh the 
branch in the Queue Process that uses the Company Address branch. 


saw 
Taestles: 


+ 
2 


fc 


patie ety He 
Fsoeat ts 


prc 


Euan 
bart eR eetS Sata ees 
reas 

+3 “> 4 2085 ¢ 


F25 
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es 
Week aneye ehe 


ANE A Bens thy 
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4.12 CREATING A GENERIC QUEUE PROCESS 


As pointed out above, the Processes folder is used to hold branch processes that we want to start 
automatically. However, there are two reasons why we may not want to save the whole Queue Process in 
this folder. 


The first reason is that when you save a branch process into the Processes folder the process is stopped and 
restarted. If you are using Print Queues, the Printer will disappear from the printer folder momentarily. 


The second reason is that the name of the root folder is computer-dependent, so if you are copying projects 
between computers either by restoring from backup or using the Administrator module, this Processes folder 
will not be the active Processes folder. 


To deal with both of these issues we will create a generic Queue Process. 


First create a new Queue Process. 





Recall Generic Queue Process ; 

Ls : aD Right-click on the Print Queue object labeled 
| eel | PTET | Parameter i | ‘Input Queue’ and select Change Type. Click 
| ase the Parameter tab and click the New button. 
re cR Language Ascii ; 
| eves Select Print Queue from the Type list and click OK 
. 15] On Job Action List twice to return to the project tree. 

exam 
ies Q First Action Print Graphic Save the branch to the Server in the Shared Resources 
| nt. folder that was created earlier. The Queue Process in 
Lo this example has been called ‘Generic’. 
Next select New from the File menu to create a new 
Queue Process. 
VS Right-click on the Queue Process object and 
a select Change Type. 
fA | c . . 
| a ieee Pea oee eg edes §=§6Sranch Shortcut Click the Branch tab and double-click on the 

Tal a ius = FormQuauesS26460 | Print Queue Generic branch. The branch will display on 

a 3 the tree with the Print Queue object as a child 
object. 

Tine oad ie uae ee 

name ‘New Queue’ in the Name box (you 

Print Queue may have to uncheck the Use Queue Process 


name checkbox). Click OK. 


Cancel 
Name [New Queud 
Now save this to the Processes folder on the 


[ Use Queue Process name Server with a name ‘New Queue’. The 
process will now be started, and a printer 
called ‘New Queue’ will appear in the Printer 
folder. 





~ Document Defaults Aretiis Sebntecmoaebestcashbasns beds ius ticbunaneessteeskesiotnmatensesbea bee bhaasaabe 


Preferred Driver [Text Only 


Tip: you can enter a partial driver name, and 
FormScape will choose the closest matching name. 


Orientation iS Fae & Sei 


+ prea sere err rer eres rr rere bret eet neers Ore tnt 00g 8 set tere ete re Tee er Tet eTRT ETE THe tte ere Rew tte eee ht won tow were reer bererie reenter ras naepae sre peesneereere eens SEE sre eres 


iP 
L 
Pp Paper Size [a4 Sheet, 210- by 297-millimeters ~| 
; 
0 
Eo 
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4.13 CONVERTING FORMSCAPE OUTPUT TO PDF FORMAT 


Third-party software can be used to convert output from FormScape to Adobe’s popular PDF format. The 
steps below explain how to achieve this using Adobe’s own PDF Distiller product. 


You must install a PostScript driver onto the computer with the FormScape Server. If you are using 
FormScape Developer remotely from the server you must install the drivers on the remote machines too. 
Apple PostScript drivers have been found to provide the best PostScript output to use with Distiller. 


1. Run the Acrobat Distiller program and select Watched Folders from the Distiller menu. Click on 
Add Folder to add a folder to the list. Select an existing folder and Distiller creates two sub- 
folders called in and out. 


tro 


Start FormScape and create a new project. 


ea 3. Change the Print Graphic object to a Print to Stream object. Ensure that the selected printer under 
aa ci the Print to Stream object is a PostScript printer. 


$9; 4. Change the child Text object to a Write File object (in the Files category). 


5. Open a file and map the information onto a form, for example as we did in Tudorl that was 
created earlier in this guide (see page 17). 


6. Click on the Write to File object — A Save As dialog is displayed. In the in folder that was created 
in step 1, enter a file name with a .ps extension. The tree should now look similar to the 
following: 








1: Tidorall Queue Process 


pe Fl Input Queue = Tutoriall Print Queue 


mR | Language Ascii 








jth 
ania] OnJob Action List 
Hie, Top Copy Print1o Stream 
| cele) Reference Printer = Detault PostScript Printer ‘Printer 
eo [Ry Petre Henater 
: ane] Write To Write File cee 
a Lye) File Path = F:\pdf'tutor1 ps Tet 
a) | 


Ba) 7. Right-click on the Action List object (labeled ‘On Job) and select Run from the menu. The file is 
— processed and an Event Log is displayed. 


The Distiller program detects that a file has been created in the watched folder, converts the 
PostScript file and places the new PDF file in the out sub-folder. Depending on the Watched 
Folders Options, Distiller will delete the Postscript file in the Distiller's in sub-folder or copy it to 
the out sub-folder. 


In FormScape v2 you can send PDF format documents as attachments to e-mail. Use the Check File object 
to ensure that the PDF file has been created. You can then use the Send Mail object to send the PDF file as 
an attachment. 
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APPENDIX A TOOLBARS AND MENUS 


The following pages list and describe the various toolbars and drop-down menus associated with the 
FormScape Developer screen. Some of these items will already be familiar to you as you have made use of 
them in the tutorial projects you have created, but the listings below can be used for reference purposes and 
to supplement your awareness of FormScape’s capabilities. 


A.1 MAIN TREE TOOLBAR AND MENUS 
The Main Toolbar in the Developer module comprises the following buttons and drop-down menus: 


File Edit Server View Options Help 


Py el | ced aad Flel¥|® MEIC alr) ai 










pJeNUOy/yOegG +> 


YOUuBIG Mau B B}eaID 
youeiq Bunsixe ue uedO 


uonoe snoiasid 8y} Opssjopun > 
syuegabey jo S}us}UuCd SMai/, 


yoursg e se joaloid au} soaes 
sessedold JeAJes BU} SIO}UO/\ 


PsEORd!|D Sy} 0} Wd}! psyosjes ay} saidoD 
$}UB]UOD PJBORMI|D eu} (Se}sed) suesu| 
YOUBIG JUBIIND BU O} S}Ndu! Jo 4SI] EU} S}IPA 


pseoqdl|D Sy} uO }! s}nd pue we}! payoejes 8y} sjnD 
}SI] BU} JO LIOWOQ/MOjSq }xeu/eAoge }xsu/do} 0} sjoS[qo SBAOW > 
Jes B}ep jsoy 8} Jo aed yseljxau/snoinsidfjejs Sy} oO} SOAOWW > 
yOslgo ue UjIM pajeloosse UONe}USWINDOP Mai/ 
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The functions of the buttons (from left to right), with their associated menus and keyboard commands, on this 
Toolbar are as follows: - 


Menu/keyboard 
command 


New branch Opens a new branch in Developer: if you are already editing a | File[New 


branch you will be prompted to save it. The new branch has a | Alt FN 
default Queue Process called Process : it is recommended to save 
Open branch 












the new branch immediately with a meaningful name 





File|Open 
Alt FO 


Opens the project browser to find an existing FormScape branch 
file. Browse through the branches until you find the one you wish 
to edit : when you select it, it is copied from the server to the 
Developer 
























File|Save 
Alt FS 
CtrlS 


Opens the project browser: enter a name for your branch. The 
current branch is then saved to the server using that filename 












Back/forward | Arrow tools allow you to flick back/forward through the branch | File|Back 
files you have been using Alt FB 
File|Forward 
Alt F F 


































Cut/copy/ Cuts the selected (highlighted) item and places it on the Windows | Edit|Cut 
paste clipboard/copies the selected item to the Clipboard/pastes the | Alt E T 
Clipboard contents to the selected location on the Developer tree. | Ctrl X 
These buttons should be used with caution to consider the | Edit|Copy 
possible effects of any existing links between the item and other | AltE C 
objects in the project Ctrl C 
Edit|Paste 










Alt E P 






Remembers the last actions you performed and enables you to 
undo/redo them 

















Undo/redo Edit|Undo 
next above, next below or bottom of the level on the tree 
moving to the start, previous, next and last page in the data set. 
Note that these four buttons are only operative if the selected item 
is a data set object e.g. a page mapper 
for the current branch. Using inputs allows you to share common } Alt V I 
data between different branches 
Processes Opens the Monitor dialog box enabling you to control and | Server| Processes 
PageBank Opens the PageBank Viewer screen enabling you to check the | View| 
and save PageBanks manually Alt VP 
Views any documentation comments associated with a selected | View|Document- 
documentation | object on the tree. Any comments added will be displayed in | ation Viewer 


Change Page | Allows you to ‘flick’ through a set of pages in a PageBank by a 
Viewer contents of a PageBank used in your project, and to delete, load | PageBankViewer 
green next to the object label. 
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The drop-down menus on this Toolbar are as follows: - 


File menu 
New Ctrl+N New — Opens a new branch file 
Open > Open — Opens a dialog box to select the source of an existing 
Save As > file from either the FormScape server or your computer’s 
Save Ctrl+S hard disk 
ween eR it alrcacae ean na ed PARMA alen tliat Save As — Opens a dialog box to save the file to either the 
Print Tree FormScape server or your computer’s hard disk. 


Save — Updates your current file 
hits Print Tree — Prints a graphic showing the tree structure as 
peer RSM she Sd ee cL RAL currently displayed (any displayed documentation comments 
Exit will also be printed) 
Sayan UaERRERUERDiaEmamenaen Back — Selects the previous branch file 
1 C:\online\percentage function Forward — Selects the next branch file 


2 C:ACUSTS\Me\Mickgéc Exit — Quits Developer (you will be asked to save your 
3 invoice print graphic project before shutting down) 
4 C:\CUSTS\Me\Mickgkc2 
Edit menu 
Undo Ctrl+Z Undo — Undoes previous action 
SSeS ee TET ~| Cut— Removes selected item and places it on the Windows Clipboard 
Cut Citas Copy — Copies selected item to the Windows Clipboard 
Copy Ctrl+C Paste — Inserts the contents of the Clipboard to the selected location 


-“ ‘ f") iid 
froth Shite 


wu! Kind/Find Next —- Opens a dialog box allowing you to select an object by name 
Find... Ctrl+F and then find it or its next occurrence on the project tree 





Server menu 


Server 


Processes.., Processes — Shows a dialog box with the activity of the server. Used to 

Reprint... start/stop individual processes in your application 

Disk Space... Reprint — Opens a dialog box to gain access to the Reprint Manager 
CHOU Sea ACTIN TT features 


__ Viewer Users... Disk Space — Opens a dialog box to display disk space usage and to allow 


you if desired to set a warning message when the disk space usage reaches 


Log off 


(nies 80% of its allocated limit (the default limit is 1OOMb). If the total space 
Change Server... used exceeds the limit, stored documents will start to be deleted 
Server Settings... Viewer Users — Displays a list of current Viewer users 
Stop carimunicetion Log off — Disconnects from currently-selected server 





Change Server — Log on to a different server 

Server Settings — Displays the current server settings. Used to control 
the FormScape working path and its logging functions 

Stop communication — Use this to stop Developer searching for the 
server. A small red cross icon at the bottom right lights up when 
Developer is communicating with the server. Click on this icon to stop 
communication 
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View menu 


Toolbar — Toggles toolbar at top of screen on/off 

‘Wloobar. Status bar — Toggles status bar (the information line at the bottom of the 
iste sein eee screen) on/off 

Enable Tooltips — Displays/hides Tooltips labelling the functions of the 
buttons 

Inputs — Opens an Inputs dialog box to add, edit or remove inputs for the 









+ Parameters:; current branch 
: PageBank¥ PageBank Viewer — Displays the current PageBank contents. 


test 





Clicking on this option (or on the View PageBank button on the main tree 
toolbar at the top of the screen) produces a window with a list of all the 
PageBanks in the current branch with data in them. If you click on one of these, the data on the current page 
is displayed and you can use the arrow keys to move forward/backward to view the pages in the selected 
PageBank. Zoom in/out buttons allow you to view the page at three different magnifications. You can delete 
a PageBank that is no longer required by selecting it in the list and pressing the keyboard DEL key to remove 
it. 

Documentation Viewer — Opens a window to allow you to insert a documentation comment alongside an 
object’s label 





Options menu 


Options 





Rae AutoSave - Enables/disables the AutoSave function, which 
unas automatically saves a copy of your current branch at regular preset 
intervals 


Print Tree Options — Sets the zoom level for printing the tree view 
Documentation — Hides/displays a documentation comment added to a 
selected object on the tree. A further option allows you to display only a 
specified number of characters of the comment (in a range of 5-200 
characters) 


Help menu 


About — Displays version details 

Tutorials — Opens Windows Helpfiles 

Reference — Displays complete list of FormScape icons arranged alphabetically 
Addon Help — For access Helpfiles for ‘add-on’ modules. 
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A.2 GRAPHICS (FORM EDITING) TOOLBAR 


The Graphics Toolbar in the Form editing screen (revealed by clicking on the Form icon) comprises the 
following buttons: - 








UO} St) UO 3X9] ASU) ————_—__»> 


wo} SY] UO aly] B NEI] ——————> 


wo] Guy UO (xOq) B[GuRja & met] ———_—_—_> 


WUD} SY} UO DE UE AVBIC] annem 


WO) Bly UD BSc UE MEIC) ————mmnge 
UO] ayy UO (JEU) SIuUdeI6 dig’) ainjaid @ WSSU] ————— 


uoTIE SNo}|AGd OU Opasjopuy] ———» { 
WO) BY] UO spose e Wasuy ————-——pP 


WUD) BY} UO SpOWeY AQ” e yssu; ———_-__-_-> 
WUsO) Bij) jO lu 1Sa} E No SewueT) ————___p» 


1S(] B WO) WO) BY] UO WaT! Je4j0 Aue yasuy ——____—_p> 
JOfue UO; ayy UO SauypUDS ay sejGbo, ———_———p 


jjosuo two ay uo Aejdsip pufi-o}-deus ain sajGBo, 
Wid} oy) UO dnosB pojoajas e woy swoy sdnosBup) ————pP> 


JJOjUO Wd) Bt] VO Sauyjapind juawubye peQUOZLUOYReMPSA ay] sajHhbo, ——____p» 
wa}! aj6uls © se Joy;oGo} WO) OU] UO SiO}! PayJoojas sdnals) 


YO/UO WO} OY] UO algo PalsojOs e JO SUO|SUDUNP pue sudiry ayy s9j550, —————» ial 


The functions of the buttons (from left to right) on this Toolbar are as follows: - 


Function Menu/ 
keyboard 
command 

‘Pick’ tool Click once on the object you wish to select. If you pick the wrong | Tool[Pick 

object because it is beneath a number of overlapping objects press | Alt T P 

Shift and click again to cycle through them until you find the desired 

object 


Zoom in/out Enlarges/reduces the size of the mapped page. You can also zoom by | Tool|ZoomIn/ 
pressing the Alt key + double click on the left mouse button (zooms | Out 


in), or Alt + double click on the right mouse button (zooms out) Alt TI 
Alt TZ 


Remembers the last actions you performed and enables you to | Edit/Undo/Redo 
undo/redo them AltEU 
Ctrl Z 
AItER 
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Text Inserts a text box on the form. Text can be rotated, justified, resized | Tool|Text 
and the font and color changed Alt T T 


Line Inserts a line on the form. You can select a line style, color and | Tool|Line 
thickness, and the line can be constrained to vertical or horizontal by | Alt T L 





pressing the Shift key whilst drawing it 


oo, 


Inserts a rectangle on the form. You can choose a border style, color | Tool{Box 
and thickness, and a color fill for the box. The box can have a} AltTB 


shadow effect added, rounded corners, and be made transparent (i.e. a 
selected color fill disabled), and can be constrained to a square by 
pressing the Shift key whilst drawing it 

Inserts an ellipse on the form. You can choose a border style, color | Tool] Ellipse 
and thickness, and a color fill for the ellipse. The ellipse can have a | Alt TE 
shadow effect added, and made transparent (i.e. a selected color fill 
disabled), and can be constrained to a circle by pressing the Shift key 


whilst drawing it 


Inserts an arc on the form. You can select a line style, color and | ToollArc 
thickness for the arc. The arc can be constrained to a quadrant of a | AItTA 
circle by pressing the Shift key whilst drawing it 


Inserts a color or black/white graphic file (must be in Windows .BMP | ToollPicture 
format) on the form. You can resize the image within FormScape | Alt T C 

and choose whether to retain the original aspect ratio or stretch the 

image horizontally or vertically 


Inserts a barcode on the form. You can set the value of the text by | Tool|Barcode 
editing the Barcode object on the tree. To map data onto the page as | Alt TR 

a barcode, drag it as a normal mapping step. Barcodes can be printed 
using Code 39, Code 128B, Interleaved 2 of 5, Codabar, UPC A, 
EAN 13, EAN 8 or Postnet symbologies, and can be printed (in black 
only) horizontally, vertically or mirrored, with/without checksums 
and with/without human readable text 


PDF barcode | Inserts a PDF (Portable Data Format) barcode on the form. This is a | Tool|PDF 
special type of barcode from Symbol Technologies and enables you | Barcode 
to encode up to approx. | kb of data Alt TF 


Other object Inserts any printable object on the form selected from a list in an | Tool|Other 
object selector box. The list comprises pictures, barcodes (including | Alt T O 
PDF format), dynamic pictures, Reporter, Page Setup, Text Box, 
Gradient, Form, OLE Object, Memory, If, Binder, Layout, Chooser, 
Set Item, Stored Document and Variable objects. For more details 
about specific objects in this list consult Appendix B 


Major Grid Shows/hides the major gridlines (vertical/horizontal dotted lines) on | View|Show 
the form Grid|Major Grid 
Alt VGM 
Minor Grid Shows/hides the minor grid (the snap grid points) on the form View|Show 
Grid|Minor Grid 
AltVGI 






















Arc 





Picture 






Barcode 


























Alignment Shows/hides the alignment guidelines on the form. You can set these | View|Show 
guidelines to any desired position on the form by clicking on the | Align Guides 
horizontal/vertical rulers and dragging AltVA 
dimensions dimensions of a selected object on the form Rulers 
AltVR 
Group/ Groups/ungroups selected objects on the form as a_ single | Edit|Group/ 
ungroup item/separate items 





Test print Prints the currently displayed form to a printer visible to your | Tool] Print Page 
computer Alt TN 
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editing or box editing on the blank form :- 


The Toolbar at the top of the screen displays the following buttons depending on whether you now select text 
Text editing 


¢——_ Text justified 
<M — _ Text right aligned 
<——_ Text centred 
——._ Text left aligned 


Wipean chee 
EeEes BOLveyosees tees, 
ECSES LOCOS Ost esBe es 

ie. ie i 
; Ps 2s 
Pict fea 
rears OPES SS 
ecreree ers ; 
opt A ‘ 
Pa Geer 
SLT: gh eon 
ere e. 
cB, sc 
5 ai bD< 
f See 
: x 


hive wot 
ete aa e 
fay 

a 


wy 

ere ret oS 
thes di thea 9 
ANaNe ee cs is 
ones ‘$ 

7 Pee 2: 
wege ¥. 
Rie reese 











mM — Text unjustified 


<q ————_ Make text coloured Rotates an arc on the form 


<——_ Make text underlined Toggles the box's coloured fill on/off 


—_——_ _ Make text italic 
—<——_ Make text bold 


Adds a drop shadow effect to the selected box 


Draws rounded corners on the selected box 


<—__ Font size (in points) 
Line thickness (in points) 


“Miew Hel 


Tool 


——- Font Line style 


Fills box with colour 


Make box frame coloured 





+——_ Additional Tools button Additional Tools button 





ac! [Arial (Wester) 


Ee 





Box editing 
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The functions of the buttons on these two toolbars are as follows :- 


Le sO | 
command 

[77 hie a Sa 
tools (More) 


Selects a font name a 
Selects a font size (in points) ae 


AltOB 
Alt OI 
AltO D 


Color Opens a color palette to select a color for the selected text Format|Fore- 
ground Color 
AltOC 


Unjustified Removes justification from a selected text Format! 

text Horizontally[None 
AltOHN 

Left aligned | Aligns the text to the left edge of the text box Format| 

text Horizontally|Left 
AtOHL 


Centered text | Centers text to the center of the text box Format| 


Horizontally| 
Right aligned | Aligns the text to the right edge of the text box 












Center 
AIOHE 
Format| 
Horizontally| 






Right 
ALOHR 


Justified text | Justifies selected text between the left and right edges of the text | Format| 
box Horizontally|Full 
AtOHU 


Color box | Opens a color palette to select a color for the rectangle/ellipse | Format|Fore- 
frame frame (i.e. the outline) ground Color 


AltOC 
Color box fill | Opens a color palette to select a color for the rectangle/ellipse fill | Format|Fill Color 
(i.e. the inside) Alt OF 


Selects a line style e.g. continuous, dashed, dotted Lt 


Selects a line thickness in points (72 points = 1 inch) 








Rounded 
corners 













Opens a dialog box to allow you to set a corner radius for a | Format|Rounded 
rectangle with rounded corners. The Rounded Corners dialog box | Corners 

allows you to specify the size of the corner radius as well as which 
of the four corners you wish to make rounded 
Opens a dialog box to allow you to produce a further 
rectangle/ellipse with a colored fill as a ‘shadow’ to your selected 
rectangle/ellipse. In this dialog box you can specify the amount of 
offset of your shadow and click on Set Color to select a color for 
the shadow from a color palette 


Toggle color | Turns a previously selected color fill on/off Format|Solid 
fill on/off AltOD 
Clicking rotates the selected arc 90° clockwise Format|RotateArc 
AILOA 
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Drop shadow 
effect 


Format|Shadow 
AltOS 












Toolbars and Menus 


The Additional Tools button 


- 
More... 
Top 
Middle 
Bottom 








Rotation... 
Line Spacing... 


More ..— Toggles between the two toolbars 

Top — Moves the text to the top of the text box 

Middle — Moves the text to the centre of the text box 

Bottom — Moves the text to the bottom of the text box 

Rotation... — Opens a further dialog box to allow you to rotate a line or lines of 
text about its centre point. Note that the rotation is carried out in an anticlockwise 
direction by the specified number of degrees 

Line Spacing .. — Opens a further dialog box to allow you to alter the line 
spacing (for text of more than one line) by specifying a point size e.g. if your text 
is in a 10 point font and you specify 20 point in the selection box, this will have 
the effect of ‘double spacing’ your lines of text 


The drop-down menus on either Toolbar are the same, as follows :- 


File menu 
ae Cael : New - Opens a branch file 
ae A : Open - Opens a dialog box to select the source of an existing file 
Aes = ctile from either the FormScape server or your computer's hard disk 
SEONG reer Uta nee Save As - Opens a dialog box to save the file to either the 
1. C:\online\percentage function FormScape server or your computer's hard disk 
2 C:\CUSTS\Me\Mickgkc Save - Updates your current file 
invoice print graphic Exit - Quits Developer (you will be asked to save your project 
4 C:\CUSTS\Me\Mickq&c2 before shutting down) 
Exit 
Edit menu 





Cut Ctrl+x 
Copy Ctrl+C 
raste hey 
ring to Erortt 
tit Bersia 
Group 
Big iaigess | 


Undo - Undo previous action 

Redo - Redo the previous action 

Cut - Removes selected item and places it on the Windows 
Clipboard 

Copy — Copies selected item to the Windows Clipboard 

Paste — Inserts the contents of the Clipboard to the selected 
location 

Bring to Front — Brings a selected item on the form to the top 
(front) in a set of overlapping items 

Put to Back — Puts a selected item on the form to the bottom 
(back) of a set of overlapping items 

Group — Groups selected items on the form and treats them as a 
single item 

Ungroup — Ungroups the items of a selected group into separate 
items 
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Format menu 


Foreground Colour... 


Fill Golour... 


ee 


Bold 
Italic 
Underline 










Horizontally . 
Vertically > 


Rotation... 
Line Spacing... 








Rounded formers... 
Shadow... 
Solid 


Rotate orc 


Offset Form... 


Tool menu 


¥ Pick 


Text 

Line 

Box 

Ellipse 

Arc 

Picture 
Barcode 
PDE Barcode 
Other 


Zoom In 
Zoom Out 


re ee cer cree e ert reer ee rte cere e renee ae remem 


Print Page 
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Foreground Colour - Opens a colour palette to select a colour for the 
selected text or box frame 

Fill Colour - Opens a colour palette to select a colour to fill the selected box 
Bold -Makes a selected text bold 

Italic - Makes a selected text italic 

Underline - Underlines a selected text 

Horizontally - Opens a further menu to allow you to align text left, right, 
center, justified or non-justified 

Vertically - Opens a further menu to allow you to justify text to the top, 
middle (i.e. centered vertically) or bottom of the text box 

Rotation - Opens a further dialog box to allow you to rotate a line or lines of 
text about its center point. The rotation is performed in an anti-clockwise 
direction from the horizontal by the specified number of degrees 

Line Spacing - Opens a further dialog box to allow you to adjust the line 
spacing of a text by specifying a point size 

Rounded Corners - Opens a dialog box to allow you to set a corner radius on 
a selected rectangle: corners can be independently selected 

Shadow - Opens a dialog box to allow you to produce a ‘drop shadow’ effect 
on your selected rectangle or ellipse (note that the shadow duplicates precisely 
the outline of the original rectangle/ellipse - you cannot e.g. have a shadow 
with rounded comers if your rectangle has square corners). The Set Colour 
button on this box allows you to choose a color from a palette for your 
shadow effect 

Solid - Turns a previously selected color fill on/off 

Rotate Arc — Rotates the selected arc 90° clockwise 


Offset Form — Opens a dialog box to allow you to shift (offset) all the items 
on the form by a vertical and/or horizontal amount specified in two boxes 


Pick - Allows you to select an existing item on the form 

Text - Inserts a text box on the form. Enter the text directly in the window, 
which then appears, and press Enter at the end of the line of text to quit the 
window. If instead you press Shift + Enter at the end of the line of text, you can 
continue onto a second line, and so on 

Line - Draws a line on the form 

Box - Inserts a rectangular box on the form 

Ellipse —Inserts an ellipse based on a rectangle drawn on the form 

Arc — Inserts an arc based on opposite corners of a rectangle drawn on the form 
Picture - Inserts a picture (Windows .BMP format) on the form 

Barcode - Inserts a barcode on the form 

PDF Barcode — Inserts a barcode using PDF format 

Other - Inserts an item from an object selector box onto the form 

Zoom In/Out - Allows you to zoom in/out of the form 


Print Page - Performs a test print of the form 


Toolbars and Menus 


View menu 


Main Toolbar — Toggles on/off the main toolbar at the top of the 
Developer screen 

Status Bar — Toggles on/off the status information line at the bottom of the 
screen 

Switch Form Toolbar — Toggles between the two toolbars available 
during form editing 

Options — Opens a dialog box with five tabs — 

Measurement — Selects measurement units (in/cm), grid size and snap 
options on the form 

Paper size — Allows you to adjust the paper size instead of using the 
default paper size set by your printer 

Background — Allows you to set a background image (e.g. as a watermark) 
on the form 

Zoom — Presets scale factors for zooming in on the form 

Font sizing —Permits you to select a font sizing method when importing 
Version | projects (see below) 

Show Grid — Toggles on/off the gridlines and snap grid points on the form 
: a submenu allows you to display/hide the gridlines (Major Grid) and the 
snap grid points (Minor Grid) on the form 

Show Rulers — Toggles on/off the vertical and honzontal rulers on the 
form, together with the dimensions of a selected item 





Show Align Guides — Toggles on/off all vertical and horizontal alignment 
guidelines on the form 


Alignment guidelines are set by clicking on the appropriate horizontal or vertical ruler and then on the form. 
A coloured vertical or horizontal line appears, which can be moved by clicking on it and dragging to the 
desired position on the form. This can be repeated for any number of further guides. To remove a particular 
alignment guideline from the form select it by clicking on it and then either click on Edit|Cut in the drop- 
down menu or use the Delete key on your keyboard. To align several objects on the form vertically or 
horizontally, use the CTRL key and mouse button to select the objects so that the last-selected object is the 
one you wish to align the others to. Click on the right mouse button to produce a further menu, and select 
‘Align’ from it. You can then choose whether to align your selected objects to the left, top, right, bottom, 
centre or middle of the last-selected object. 


This further menu, in addition to gaining access to the ‘Align’ options, also contains a number of options 
which allow you to cut, copy and paste a selected object, and put it to the back or bring it to the front of a 
number of overlapping objects. The ‘pick up style’ and ‘apply style’ options are used to enable you to make 
an object have exactly the same attributes as another object on the form. For a text object the attributes 
which you can ‘pick up’ by selecting the first object and then ‘apply’ to the second object by selecting it are 
the colour, font, font size, line spacing, bold/italic/underline and justification settings, whilst for a box or 
ellipse object the attributes are the frame colour, thickness, line style, fill colour, and drop shadow and 
rounded corner settings. For a line or arc object the attributes are the line colour, thickness and line style. 


In the Properties option by entering new values for the position of the selected object’s edges or its 
dimensions you can also resize it or reposition it on the form when you click on the Apply button. 
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Preferences xX 


Measurement | Paper Size | Background | Zoom Font sizing | 


FormScape offers two methods of font sizing. Earlier versions 
of FoimScape used cell sizing where the size represents the 
height of the character cell, but for maximum compliance you 
should use text sizing. 


Note: Changing the method will alter the size at which the 
text will be printed and displayed. 


™ Cell Sizing 
@ TreaSing 





In the Options|Font sizing item you must choose when importing a FormScape project previously developed 
in Version | whether to retain the original character cell size for text (click the ‘Cell sizing’ button), or 
change it by clicking the ‘Text sizing’ button. If you do this, the text will appear and print out more 
accurately in the Version 2 project. 


Help menu 





i poet i About — Displays version details 
Tutorials | Tutorials - Opens Windows Helpfiles 
Retscnce _ Reference — Displays complete list of FormScape icons arranged alphabetically 
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A.3 PAGE PREVIEW (PRINT GRAPHIC) TOOLBAR 


The Page Preview Toolbar in the Print Graphic screen (revealed by clicking on the Print Graphic icon) 
comprises the following buttons: - 


The functions of the buttons (from left to right) on this toolbar are as follows: - 





Menu/keyboard 
command 


Previous/next | Moves to a full page preview of the previous/next pages of your | Preview| Forward/ 
pages completed form Back 

AltP F/ AltPB 
Allows you to zoom in/out of your page preview Preview|Zoom In/ 

Out 

AltPI/ AltPO 


a the page preview when a change has been made to the | Preview|Update 
Alt PU 









Zoom in/out 
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The drop-down menus associated with this toolbar are as follows: - 


File menu - identical to the File menu previously described 
Edit menu 


STR ye Undo — Undoes previous action 

__ nds ee : Cut — Removes selected item and places it on the Windows Clipboard 
: 7 Copy — Copies selected item to the Windows Clipboard 

Paste — Inserts the contents of the Clipboard to the selected location 






‘ a8 


Paste Chk: 





Preview menu 


Forward — Moves to a preview of the next page of your print job 

Back — Moves to a preview of the previous page of your print job 

Zoom In/Out — Allows you to zoom in/out of the form preview 

Update - Refreshes the preview when a change has been made to the tree 





View menu 


ert 












; “Toolbar : : . Toolbar — Toggles main toolbar at top of screen on/off 

'v Status Bar? Status bar — Toggles status bar (the information line at the bottom of the screen) 
Spe OS Te alate 
Help menu 


About — Displays version details 
Tutorials — Opens Windows Helpfiles 


Reference — Displays complete list of FormScape icons arranged alphabetically 
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A.4 SPLITTER OBJECT TOOLBAR 


The Splitter Toolbar (revealed by selecting the Splitter object in the Change Object window and clicking on 
it) comprises the following buttons :- 
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The functions of the buttons (from left to right) on this toolbar are as follows :- 


Menu/ keyboard 

command 
First/previous/ | Moves to the first/previous/next/last page in the PageBank Splitter|First page/ 
next/last page NextPage/ 

PreviousPage/ 

Last Page 

AltS F/S N 


AltS P/S L 


PageBank Enter or select the PageBank name. Changing this will alter the 
name associated text object on the tree 


Scroll Moves the top of the page up/down by one line at a time to define | Splitter|Adjust 
up/down where on the data set the page starts (also possible by dragging | Offset Up/Down 
down the top of the page) 


Open Splits the current pane into two and opens either upper or lower | Splitter| 
Upper/Lower | half page mapper OpenUpper Half/ 
Half Open Lower Half 
Alt S O/ 
AltS P 
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The drop-down menus associated with this toolbar are as follows: - 
File menu - identical to the File menu previously described 


Edit menu - identical to the Edit menu previously described 


Splitter menu 







: ~ Aust Offset Up Adjust Offset Up/Down — Scrolls up/down the selected page by one line at a 
= “Adjust. Offset Down” time 

Eee First/Next/Previous/Last Page — Move to the appropriate page in the current 
: ‘et Page, ae Open Upper/Lower Half — Opens the upper/lower half of the page divided 
. Beevious! Page SONS : sid : 


ae into two by the Splitter object 
: _ Last Pay ge: oe 


' figs nppet ola 


View menu - _ identical to the View menu previously described 


Help menu - identical to the Help menu previously described 
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A.5 MAPPER OBJECT TOOLBAR 


The Mapper Toolbar (revealed by selecting the Mapper object in the Change Object window and clicking on 
it) comprises the following buttons: - 
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The functions of the buttons (from left to right) on this toolbar are as follows: - 


Function Menu/ keyboard 
command 


First/previous Moves to the first/previous page in the PageBank Mapper| First 
page Page/ 
Previous Page 
Alt MF 
Alt M P 


Displays or allows entry of a page number in the PageBank oo 


Next/last page Moves to the next/last page in the PageBank Mapper|Next 
Page/ 
Last Page 


Alt MN 


AltM L 


Zoom in/out Allows you to zoom in/out of your PageBank view Mapper|Zoom 
In/Out 
AItMI/MO 


PageBank name | Displays or allows entry of a PageBank name 


Block name Displays or allows entry of a text name for the currently selected 
block in the PageBank 


Cursor Displays either the current cursor position (if no block is selected) 

position/size of | or the position and size of the selected block. X is the column 

block number, Y the row number, W the block width in columns and H 
the block height in rows 
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The drop-down menus associated with this toolbar are as follows: - 


File menu — identical to the File menu previously described 


Edit menu 





Mapper menu 
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Undo — Undoes previous action 

Redo —Redoes the previous action 

Cut — Removes selected item and places it on the Windows Clipboard 

Copy — Copies selected item to the Windows Clipboard 

Paste — Inserts the contents of the Clipboard to the selected location 

Properties — Allows you to set the space trimming and line merging properties of 
the selected text box 


Explore — Splits the mapper screen in two and opens the tree at the location of the 
currently—selected block 


Adjust Offset Up/Down — Moves the top of the page up/down one line at a 
time 

First/Next/Previous/Last Page — Move to the appropriate page in the 
PageBank 


Zoom in/out — Allows you to zoom in/out of the PageBank screen 


View menu- _ identical to the View menu previously described 


Help menu - identical to the Help menu previously described 
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APPENDIX B 


Add point 
BMP 


COLD 


Conditional text 


Conditional processing 


File Queue 


FormScape Server 


FormScape Server Lite 
FormScape Developer 
FormScape Administrator 


FormScape Extended 
Reprint Manager 


.FSP 





GLOSSARY OF TERMS 


The empty square box/stub at the end of a branch of the Developer project 
tree 


File extension for a Windows bitmap file, the file format required to 
import graphics into FormScape 


Computer Output to Laser Disc (data storage system) 


Text which appears on selected pages of a data sample which have been 
specified according to a predetermined set of conditions 


The process whereby a text string is made to appear on selected pages of 
a data set instead of all of them, the pages being selected by a set of 
conditions previously established in the Developer module 


Method of collecting data from the network for FormScape systems 
running in Windows 95 (see also Print Queue) 


This software module processes the print data received from other 
applications. Once installed and started it requires no further user 
intervention, and is controlled by the other software modules in the 
FormScape suite of programs 


This module has the same functionality as the Server module, but is 
restricted to operating only two printers 


This is the software module which creates and manages the project for a 
number of Server modules or sites 


This optional software module provides document or FormScape project 
management from a single centralized point 


This optional software module allows any document processed by the 
Server module to be retrieved, viewed and reprinted using the FormScape 
Viewer table 


File extension for a saved FormScape project : includes everything 
needed to run the application - forms, data samples, decisions etc. 
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GUI 


Input page 


Input Queue 


Language Interpreter 


Legacy system 


LPD 


ODBC 


OLE 


PageBank 
PDF 

PCL 
POP3 


Print Queue 


Print Graphic 


SMTP 


TCP/IP 


WORM 
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Graphical User Interface, the Windows feature which permits you to 
create complex projects graphically using the Developer module instead 
of writing lines of programming code 

One of the pages of input data from the host system 


The object on the Developer project tree responsible for collecting data 
from the host system 


The object on the Developer project tree responsible for taking data from 
the Input Queue, breaking it down into pages and storing it in a PageBank 


An existing data management system on the host system, completely 
unaffected by the installation of the FormScape software modules 


Line Printer Daemon, the means by which the network system can send 
(using the TCP/IP protocol) data to a FormScape Input Queue 


Open Database Connectivity, a system to provide database integration 


Object Linking and Embedding, a method of sharing data between 
different applications 


Where the data from the host system is stored in pages in FormScape 
Portable Data Format, a format for creating barcodes from a data set 
Page Control Language, a printer protocol used by FormScape 

Post Office Protocol Version 3, a type of e-mail format 


Preferred method of collecting data from the network for FormScape 
systems running under Windows NT4 (see also File Queue) 


The object on the Developer project tree, which takes the completed form 
and sends it to a printer 


Simple Mail Transfer Protocol, a protocol used with e-mail messages 


Transmission Control Protocol/Internet Protocol, the preferred network 
protocol for FormScape connectivity 


“Write Once, Read Many”, a type of storage medium e.g. CD-ROM and 
some magneto-optical media types 


INDEX 


A 


Add 
Add Page 


B 


Binder 
Builder 


Cc 


Choice 
Chooser 
Copy Number 
Copy Text 


D 


Date to Number 
Dynamic Picture 


E 
Empty 
F 


File Queue 
Form 


H 
HelpLinks 
L 


Layout 

Line Filter 

links 
HelpLinks 


M 


Mapper 
Memory 


N 
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Number to Date 
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HelpLinks 3 
Overlay Choice 60 
Overlay Chooser 59 
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P 
Page Setup 33 
Page Switch 36, 37 
Page Type 36, 37 
PageBank 37, 43, 46, 51, 88 
Picture 38 


Print Graphic32, 43, 45, 46, 50, 51, 53, 55, 60, 61, 
63, 88 


Print Queue 59, 66, 87, 88 
Printer ; 54, 59 
Q 
Queue Process 36, 38, 45, 63, 64 
R 
Range 50, 51 


Reporter 32, 38, 43, 47, 48, 53, 54, 55, 61, 63 
5 


Scan 45, 46, 50, 51, 55, 57 
Scheduler 45 
Sentence 34, 41, 57, 62 
Server 87 
Splitter 43, 44, 84 
Subtract 35 
T 

Text 34, 39, 50, 51, 57, 61 
Text Box 39, 53, 57, 61, 62, 63 
Time 41, 42 
Total 46 
Y 

Yes/No 61 
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FORMS CAPE 


@MPOWERING BUSINESS COMMUNICATIONS 


Empower your Business 
Communications with FormScape 
- within hours 


www .tformscape.com 





email: info@formscape.com 





Enterprise Output 
Management 


